Der Standard für Konfigurationsdateien wird von freedesktop.org so definiert: Eine Konfigurationsdatei <Anwendung-Name>.<Extension> wird im Verzeichnis ~/.config/ gespeichert. Die Extension der Konfigurationsdatei ist frei wählbar. Empfohlen wird 'conf'. Gambas3 hält sich mit der Klasse Settings sowie mit den eigenen Konfigurationsdateien an diesen Standard.
Die Konfigurationsdatei ist in der Standardeinstellung der eingesetzten Settings-Komponente eine einfache Textdatei *.conf und kann zum Beispiel zum Einfügen von Kommentaren mit einem Texteditor nachträglich bearbeitet werden. Das ist möglich, weil der Pfad einer Konfigurationsdatei ein Lesen und Schreiben vom angemeldeten Benutzer zulässt:
User.Home &/ ".config/gambas3" &/ Application.Name & ".conf"
Folgende Hinweise für den Inhalt einer Konfigurationsdatei sind zu beachten:
[Expander] ExpanderHiddenStatus=False [V24Konfiguration] Port-Name="ttyUSB0" Geschwindigkeit="9600" Parität="NONE" ... Datenflusskontrolle="NONE" <LEERZEILE>
Auf die Konfigurationsdaten in der Konfigurationsdatei wird zur Programmlaufzeit über die Kombination Sektionsname/Schlüssel oder beim Programmstart bei nicht vorhandenem Schlüssel-Wert-Paar auf den Vorgabewert zugegriffen, wie der folgende Ausschnitt aus dem Quelltext für das Projekt Temperaturmessung im Ereignis Form_Open() zeigt:
Syntax: Wert = Setting-Objektname["Sektionsbezeichner/Schlüsselname", optional "Vorgabewert"] expRX_TX.Hidden = v24Settings["Expander/ExpanderHiddenStatus", TRUE] ---> False cmbSpeed.Text = v24Settings["V24Konfiguration/Geschwindigkeit", "4800"] ---> 9600 cmbParity.Text = v24Settings["V24Konfiguration/Parität", "NONE"] ---> NONE
In den folgenden Abschnitten werden Projekte vorgestellt, bei denen
Für alle vorgestellten Projekte sind die folgenden Schwerpunkte gesetzt:
Zur Verwaltung der Konfiguration der Anwendung müssen Sie die Komponente gb.settings in Ihr Projekt einbinden.