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.
Anmerkungen
Wenn die Gruppe noch nicht existiert, wird sie nicht sofort erstellt. Stattdessen wird sie erstellt, sobald der erste Schlüssel in diese geschrieben wird. Dies ermöglicht die Verwendung der PreferenceGroup()-Funktion zum Testen, ob eine Gruppe vorhanden ist, ohne viele leere Gruppen zu erstellen. Bei der Suche nach Gruppen wird die Groß-/Kleinschreibung nicht beachtet.
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("Schlüssel der 'Window' Gruppe", PreferenceKeyName() + " = " + PreferenceKeyValue()) ; ...den Schlüssel mit seinen Daten anzeigen
Wend
; Schließt die Preference-Datei
ClosePreferences()
Unterstützte OS
Alle