| Element |
Attribute |
Beschreibung |
| configfile |
|
Das Wurzelelement. Es darf nur
einmal in der Datei auftauchen (und zwar am Anfang) und
umschließt alle anderen Elemente. Es bildet sozusagen den Rahmen
der Konfiguration und kann nur Gruppen enthalten. |
| |
name |
Hier wird der Name der Konfiguration hinterlegt. Er wird im Dialog DOSBox Konfigurationen angezeigt. |
| |
dosboxversion |
Die DOSBox-Version, die durch
dieses Konfigurationsdatei beschrieben wird. Sie dient bisher nur der
Information und hat keine weitere Bedeutung. |
| |
|
|
| group |
|
Dieses Element beschreibt eine Gruppe und fasst Sektionen zusammen. In
den Oberflächen wird eine Gruppe durch einen Tab-Reiter dargestellt. Eine Gruppe kann nur Sektionen enthalten. |
| |
name |
Der Name der Gruppe, der im Tab-Reiter angezeigt wird. |
| |
|
|
| section |
|
Dieses Element beschreibt eine Sektion. In den Oberflächen wird eine Sektion durch einen beschrifteten Rahmen dargestellt. Sektionen können nur Items enthalten. |
| |
name |
Der Name der Sektion, der als Rahmenüberschrift angezeigt wird. |
| |
|
|
| item |
|
Das Items schließlich ist das
Element, das einen Parameter der DOSBox-Konfiguration darstellt.
Deshalb muss hier sehr genau darauf geachtet werden, wie und was man
editiert. Ansonsten kann es zu seltsamem Verhalten seitens DOSBox
kommen, wenn ein Parameter falsch benutzt wird. |
| |
name |
Der Name des Items. Er muss
immer genauso lauten, wie der zugehörige Parameter der
DOSBox-Konfig-Datei! Auch die Groß-Kleinschreibung beachten. Denn
dieser Text wird später direkt in einer Konfigurationdatei
abgelegt und an DOSBox übergeben wenn die Applikation gestartet
wird. Weiter unten wird es Beispiele dafür geben, wie die Relation
zwischen Item-Definition und DOSBox-Parameter aussieht. |
| |
value |
Dieses Attribut stellt den aktuellen Wert dar für den Parameter (definiert durch obiges Attribut name).
Hier kann das Attribut zum Einstellen des Standardwertes dienen und
sollte (muss aber nicht) immer derjenige sein, den auch DOSBox vorgibt. |
| |
type |
Das Typ-Attribut ist dasjenige,
welches das Aussehen des Items in der Oberfläche festlegt. Je nach
Art des einzustellenden Parameters ist eine bestimmte Komponente
sinnvoll. Folgende Typen stehen zur Auswahl:
- bool Zeichnet eine
beschriftete Box zum Setzen eines Häkchens. Es sind somit nur die
Zustände an/aus für den Nutzer auswählbar.
- number Stellt ein
Textfeld zur Verfügung, in das der Nutzer eine beliebige Zahl
eintragen kann. Derzeit findet noch keine Validierung statt, ob der
eingegebene Text auch wirklich eine Zahl ist.
- text Stellt ebenfalls ein Textfeld zur Verfügung, das zum Eingeben eines beliebigen, einzeiligen Textes dient.
- multiline_text Stellt dem Benutzer ein mehrzeiliges Textfeld zur Verfügung, das auch Zeilenumbrüche verarbeiten kann.
- choice Hier wird eine Abrollbox dargestellt, die mehrere vordefinierte Werte anbietet, aber nur einer von ihnen ist auswählbar.
- file Dieser Typ
präsentiert ein Textfeld, in dem der vollständige Pfad zu
einer beliebigen Datei eingetragen werden kann und zusätzlich
einen Knopf, der einen Dateiauswahl-Dialog zum komfortablen Navigieren
zur Verfügung stellt.
- directory Funktioniert genauso wie der Typ file,
aber es können nur Verzeichnisse/Ordner ausgewählt werden,
keine Dateien. Derzeit findet noch keine Validierung statt, ob ein von
Hand eingetragener Pfad auf eine Datei oder ein Verzeichnis zeigt. Der
Einsatz des Dateiauswahl-Dialogs wird deshalb empfohlen.
|
| |
values
(nur für den Typ choice nötig) |
Hier werden die verfügbaren
Werte für die darzustellende Abrollbox hinterlegt. Es handelt sich
hierbei um eine Zeichenkette, deren einzelne Werte durch ein Komma (",")
getrennt werden. Das bedeutet natürlich, dass Werte niemals ein
solches Komma in ihrem Namen haben dürfen, sonst würde der
Teil hinter dem Komma als neuer Wert interpretiert werden. Zu beachten
wäre noch, dass das XML-Format bestimmte Zeichen reserviert hat.
Dazu zählen zum Beispiel: <, >, "
Die Werte können normalerweise durch Kopieren und Einfügen
per Zwischenablage direkt aus der DOSBox-Konfigurationsdatei entnommen
werden. |
| |
choices
(nur für den Typ choice nötig) |
Eine Zusatzoptionen bildet dieses
Attribut. In DOSBox gibt es den Sonderfall, dass Werte mehrfach und
durch ein Komma getrennt einem Parameter zugewiesen werden. Zu diesem
Zweck wurde dieses Attribut eingeführt. Als Wert wird eine Zahl
> 1 angegeben, die bestimmt, wieviele Abrollboxen angezeigt werden
sollen.
Standardmäßig steht der Wert auf 1, er muss also wirklich
nur dann angegeben werden, wenn mehr als eine Abrollbox nötig ist.
Alle Abrollboxen enthalten dieselben Werte, wie sie im Attribut values angegeben wurden. Unten findet sich ein entsprechendes Beispiel dafür. |
