CreatePreferences()

Syntax

Ergebnis = CreatePreferences(Dateiname$ [, Flags])

Erstellt eine neue leere Preference-Datei. Existiert diese Datei bereits, so wird diese gelöscht.

Parameter

Dateiname$

Der Dateiname der neuen Preference-Datei.

Flags (optional)

Dies kann eine Kombination der folgenden Werte sein: #PB_Preference_NoSpace: es werden keine Leerzeichen rings um das Gleichheitszeichen (=) - zwischen Schlüssel und Wert - eingefügt, Dies kann nützlich beim Umgang mit externen Voreinstellungs-Dateien sein, welche kein Leerzeichen rings um das Leerzeichen akzeptieren. #PB_Preference_GroupSeparator: fügt eine leere Zeile zwischen den Gruppen ein, um die Lesbarkeit der Datei zu erhöhen.

Rückgabewert

Ein Wert ungleich Null, wenn die Datei erfolgreich erstellt wurde, andernfalls Null.

Anmerkungen

Sobald die Datei erfolgreich erstellt wurde, können Befehle zum Schreiben von Daten wie WritePreferenceString() genutzt werden. Wenn Werte in die Preference-Datei geschrieben wurden, ist es möglich, diese mit Funktionen wie ReadPreferenceString() wieder einzulesen.

Zum Entfernen eines Schlüssels oder einer Gruppe gibt es die Befehle RemovePreferenceKey() und RemovePreferenceGroup(). Zum Erstellen oder Ändern einer Gruppe verwenden Sie PreferenceGroup().

Sobald alle Schreib-Operationen erfolgt sind, muss ClosePreferences() aufgerufen werden, um die Einstellungen tatsächlich auf Disk zu speichern.

Beispiel

  ; Erstellt eine Preference-Datei namens Setup.ini
  CreatePreferences(GetTemporaryDirectory()+"Setup.ini")
  
  ; Erstellt eine Gruppe namens "Window"
  PreferenceGroup("Window")
    WritePreferenceLong("X", 10)      ; X = 10
    WritePreferenceLong("Y", 10)      ; Y = 10
    WritePreferenceLong("W", 800)     ; W = 800
    WritePreferenceLong("H", 600)     ; H = 600
    WritePreferenceFloat("%", 20)     ; % = 20.000000
    WritePreferenceString("Title", "PureNote") ; Title = "PureNote"
  
  ; Schließt die Preference-Datei
  ClosePreferences()

Siehe auch

ClosePreferences()

Unterstützte OS

Alle