Settings (gb.settings)
Deze class beheert de algemene configuratiebestanden.
Deze klasse kan gebruikt worden als een object door een verborgen instantie op verzoek te creëren.
Deze klasse is
creëerbaar.
Deze klasse reageert als een
leesbaar /
schrijf reeks.
|
FromString
|
Return a value from its settings internal string representation
|
|
ToString
|
Convert a value into its settings internal string representation
|
Eigenschappen
|
Count
|
Return the number of entries in the settings file
|
|
Keys
|
|
|
Path
|
Deze eigenschap geeft de standaard map waar configuratiebestanden worden bewaard.
|
Methode
|
Clear
|
Wist alle instellingen.
|
|
Exist
|
Return if the specified settings key has a value
|
|
Read
|
Initialiseert het bewuste object met waarden uit het configuratiebestand.
|
|
Reload
|
Verliest alle wijzigingen aan de instellingen door de bestaande instellingen terug op te halen uit het configuratiebestand.
|
|
Save
|
Bewaart het configuratiebestand op de harde schijf.
|
|
Write
|
Schrijft de instellingen van het opgegeven object in het configuratiebestand.
|
Als je deze class statisch gebruikt dan zal het standaard project-configuratiebestand gebruikt worden.
Het pad van het standaard configuratiebestand is:
User.Home &/ ".config/gambas" &/ Application.Name & ".conf"
Het configuratiebestand voor de ontwikkelomgeving is bv opgeslagen als
~/.config/gambas/gambas2.conf
Dit voorbeeld haalt de plaats van het venster op het scherm uit een bestand, op het moment dat een form geopend wordt. Als het bestand niet bestaat dan zal de standaard plaats van het venster gebruikt worden. Als de form gesloten wordt, wordt de positie bewaard in het bestand. Als bestand wordt het standaard instellingen- of configuratiebestand gebruikt.
Examples
PUBLIC SUB Form_Open()
' Update window position from settings file
' If the settings file is not found then
' use default position.
ME.Top = Settings["Window/Top", ME.Top]
ME.Left = Settings["Window/Left", ME.Left]
ME.Height = Settings["Window/Height", ME.Height]
ME.Width = Settings["Window/Width", ME.Width]
END
PUBLIC SUB Form_Close()
' Save window settings when application closes
Settings["Window/Top"] = ME.Top
Settings["Window/Left"] = ME.Left
Settings["Window/Height"] = ME.Height
Settings["Window/Width"] = ME.Width
END
Het bestand met de bewaarde instellingen, gegroepeerd onder de titel Window zou er ongeveer zo uitzien:
[Window]
Top=13
Left=18
Height=154
Width=235
Merk op dat je onmiddellijk de
Write kan gebruiken om de instellingen van een venster op te slaan, en de
Read method om ze terug op te halen.