PreferenceGroup()
Syntax
Ergebnis = PreferenceGroup(Name$)Beschreibung
Erstellt eine neue Gruppe (in der Form: [Name$]) oder ändert die aktuelle Gruppe in der Preference-Datei.
Alle folgenden Lese- oder Schreib-Operationen sind dann auf diese Gruppe beschränkt. Um alle Gruppen zu verlassen, kann ein leerer 'Name$' verwendet werden.
Parameter
Name$ Der neue Gruppen-Name.
Rückgabewert
Ein Wert ungleich Null, wenn die Gruppe bereits existierte, andernfalls Null.
Beispiel
; Öffnet eine Preference-Datei
OpenPreferences(#PB_Compiler_Home +"Examples\Sources\Data\test.pref")
; Auswählen einer Gruppe
PreferenceGroup("window")
; Schlüssel in der Gruppe 'window' untersuchen
ExaminePreferenceKeys()
While NextPreferenceKey() ; Solange ein Schlüssel existiert...
MessageRequester("Keys from the 'window' group", PreferenceKeyName() + " = " + PreferenceKeyValue()) ; ...den Schlüssel mit seinen Daten anzeigen
Wend
; Schließt die Preference-Datei
ClosePreferences()
Anmerkungen
Wenn die Gruppe noch nicht existierte, wird diese nicht sofort erstellt. Sie wird stattdessen erstellt, sobald der erste Schlüssel in diese geschrieben wird. Dies ermöglicht die Verwendung des PreferenceGroup() Befehls zum Testen, ob eine Gruppe existiert, ohne das Erstellen vieler leerer Gruppen.
Unterstützte OS
Alle