LitSoz 2.0: Form Definition File Format (*.fdf)

Inhalt

1. Einleitung
2. Aufbau der FDF-Dateien
2.1 <options>-Tag
3. Komponenten
3.1 <authors/> und <editors/>
3.2 <edit>
3.3 <dateedit>
3.4  <wwwedit>
3.5 <fileedit>
3.6  <combobox>
3.7 <listbox>
3.8 <memo>
3.9 <label>
3.10 <image>
3.11 <panel>
3.12 <groupbox>
3.13 <pagecontrol>

 
 


1. Einleitung

In FDF-Dateien werden die sog. dynamischen Formulare beschrieben, die von LitSoz benutzt werden, um je nach Art des Datensatzes (Monographie, Roman, Zeitungsartikel ...) eine andere Eingabemaske (Formular) auf der Bildschirmseite erweitert anzuzeigen.

Bei FDF handelt es sich seit Version 2.0 um eine XML-Anwendung, was neue Möglichkeiten im Gegensatz zum alten Format eröffnet (z.B. verschachtelte Komponenten).

Im folgenden werden alle (Eingabe-)Elemente, die in den FDF-Dateien definiert werden als Komponenten bezeichnet.


 


2. Aufbau der FDF-Dateien

FDF-Dateien sind (wie gesagt) XML-Anwendungen. Das bedeutet, dass sie einen Root-(Wuzel)-Tag (<lfdf_form>) besitzen, der alle untergeordneten Tags enthält. Ihm sind zwei Typen von Tags untergeordnet:

 
 
 


2.1 <options>-Tag


3. Komponenten

Positionierung

Die Abbildung zeigt beispielhaft ein einfaches Eingabefeld, um die Geometrie und damit die Bedeutung der Attribute zu erklären. Jeder Komponente wird ein Beschreibungstext zugeordnet. Sein Inhalt steht in der Eigenschaft captiontext. Das Datenfeld, auf das zugegriffen werden soll wird in der Eigenschaft datafield angegeben.

Die Positionierung der Komponenten erfolgt normalerweise automatisch. Die Beschriftung erhält eine vorgegebene Standardbreite (captionwidth), genauso wie das Editierfeld (editwidth o.ä..). Die Positionierung mehrerer Komponenten erfolgt von oben nach unten mit einem standardmäßigen Abstand. Will man die Positionierung ändern kann man die Position der Komponente auf dem Bildschirm mit den Eigenschaften left (x-Koordinate) und top (y-Koordinate) in Pixeln festlegen.
 

Attribute

Die Eigenschaften von Komponenten können auf zwei Arten beschrieben werden. Der Standard-Weg ist es, die Eigenschaften in die entsprechenden Attribute des Tags einzutragen. Diesen weg sollte jeder einschlagen. Um die Kompatibilität zu älteren Entwicklungsversionen (und deren FDF-Dateien) von LitSoz zu gewähren ist es aber auch möglich gleichnamige Untertags zu benutzen, die die Information enthalten. Dieser Hinweis steht hier vor Allem, um Verwirrung auszuschließen, die bei der ARbeit mit älteren FDF-Dateien entstehen könnte.
 


3.1 <authors/> und <editors>

Wenn diese Tags in einer FDF-Datei vorkommen werden die entsprechenden Eingabeelemente angezeigt.
Dabei aktiviert <authors/> die Eingabeelemente für Autorennamen und <editors/> die Eingabezeile für Herausgeber (engl. editors). Die tags haben keine Attribute und dürfen keine untergeordneten Tags enthalten.
 

Beispiel:

<authors/>
<editors/>
 
 


3.2 <edit>

 
 


3.3 <dateedit>

 
 


3.4 <fileedit>

 
 


3.5 <wwwedit>

 
 


3.6 <combobox>


 


3.7 <listbox>


 


3.8 <memo>


3.9 <label>

 


3.10 <image>


3.11 <panel>

<panel>
  <items>
    <label captiontext="captiontext" editbackgroundcolor="clWhite" width="300"/>
    <label datafield="Num" captiontext="captiontext" width= "300" />
    <edit captiontext="captiontext" datafield="Titel" editwidth="300"/>
    <memo captiontext="captiontext" datafield="Untertitel" editwidth="300"/>
  </items>
</panel>


3.12 <groupbox>

<groupbox captiontext="captiontext">
  <items>
    <label captiontext="captiontext" editbackgroundcolor="clWhite" width="300"/>
    <label datafield="Num" captiontext="captiontext" width= "300" />
    <edit captiontext="captiontext" datafield="Titel" editwidth="300"/>
    <memo captiontext="captiontext" datafield="Untertitel" editwidth="300"/>
  </items>
</groupbox>


3.13 <pagecontrol>

<pagecontrol captiontext="captiontext" tabposition="left">
  <page caption="Page 1">
    <label captiontext="caption" editbackgroundcolor="clWhite" width="300"/>
    <label datafield="Num" captiontext="caption" editbackgroundcolor="clWhite" width="300"/>
    <edit captiontext="caption" datafield="Titel" editwidth="300"/>
    <memo captiontext="caption" datafield="Untertitel" editwidth="300"/>
  </page>
  <page caption="Page 2">
    <label captiontext="caption" editbackgroundcolor="clWhite" width="300"/>
    <label datafield="Num" caption="captiontext" editbackgroundcolor="clWhite" width="300"/>
    <edit captiontext="caption" datafield="Titel" editwidth="300"/>
    <memo captiontext="caption" datafield="Untertitel" editwidth="300"/>
  </page>
</pagecontrol>

 
 
 
 
 
 
 


erstellt/bearbeitet: 25. August 2001     --  © 2001 by Jan W. Krieger ( jan@jkrieger.de)