3.60 DM_SaveProfile
Diese Funktion schreibt die aktuellen Werte aller konfigurierbaren Record-Instanzen (.configurable = true) und globalen Variablen (deklariert mit config) eines Dialogs oder Moduls in eine Konfigurationsdatei (profile), aus der sie mit der Funktion DM_LoadProfile() wieder geladen werden können.
Bei Records werden standardmäßig nur Werte, die nicht geerbt sind, in die Datei geschrieben. Um auch die geerbten Werte in die Datei zu schreiben ist der Parameter options auf DMF_SaveAll zu setzen.
Es werden nur Werte aus dem angegebenen Dialog oder Modul gespeichert. Aus anderen Modulen importierte Records und Variablen werden nicht berücksichtigt.
DM_Boolean DML_default DM_EXPORT DM_SaveProfile
(
DM_String filename,
DM_ID dialog,
DM_String comment,
DM_Options options
)
Parameter
-> DM_String filename
Dieser Parameter definiert den Dateinamen der Konfigurationsdatei. Es kann ein Dateipfad angegeben werden, der auch eine Umgebungsvariable enthalten darf.
-> DM_ID dialog
Dieser Parameter enthält den Identifikator des Dialogs oder Moduls, dessen Record- und Variablenwerte in die Datei geschrieben werden sollen.
-> DM_String comment
In diesem Parameter kann ein Text angegeben werden, der als Kommentar in die Konfigurationsdatei geschrieben wird.
-> DM_Options options
Hier sind folgende Optionen möglich:
|
Option |
Bedeutung |
|---|---|
|
DMF_SaveAll |
Schreibt zusätzlich die geerbten Werte in die Konfigurationsdatei. |
Rückgabewert
|
DM_TRUE |
Das Speichern der Werte in der Konfigurationsdatei war erfolgreich. |
|
DM_FALSE |
Die Werte konnten nicht gespeichert werden. Dies kann an Fehlern beim Zugriff auf die Datei oder einer ungültigen Modul-ID liegen. |
Verfügbarkeit
Siehe auch
C
Support