3.44 DM_LoadProfile

Mit dieser Funktion können die vom Benutzer veränderbaren Variablen aus einer Datei eingelesen und vom Dialog Manager verarbeitet werden. Damit ist es möglich, Dialoge durch den Endanwender beeinflussbar zu machen, ohne dass dieser Endanwender den Dialog in Source oder den Dialog Manager hat.

DM_Boolean DML_default DM_EXPORT DM_LoadProfile
(
  DM_ID dialog,
  DM_String filename,
  DM_Options options
)

Parameter

-> DM_ID dialog

Dieses ist der Identifikator des Dialoges, zu dem das angegebene Profile eingelesen werden soll.

-> DM_String filename

Dieser Name bezeichnet den Namen der Profile-Datei.

Hierbei gilt wie bei allen Dateizugriffen, dass der angegebene Name wie folgt aufgebaut sein darf:

Umgebungsvariable:Name der Dialogdatei.

Die vorangestellte Umgebungsvariable dient als Pfad, unter dem die Dialogdatei gesucht werden soll.

In der Dialogbeschreibungsdatei steht z.B.

config variable integer HUGO;

Diese Variable soll nun mittels der Profile-Datei gesetzt werden. Die Datei sieht dann wie folgt aus:

HUGO := 5;

-> DM_Options options

Unbenutzt. Muss 0 sein.

Rückgabewert

TRUE

Datei konnte eingelesen werden.

FALSE

Datei konnte nicht eingelesen werden.

Beispiel

Dialogdatei

dialog YourDialog

{

}

config variable string WindowText := "Sorry no profile";

config variable integer WindowXPos := 5;

config variable integer WindowYPos := 5;

 

window W1

{

    .width 25;

    .title "Testwindow";

    .visible false;

    .xraster 10;

    .yraster 16;

    .posraster true;

    .sizeraster true;

    child pushbutton End

 

    {

    .xleft 7;

    .width 9;

    .height 2;

    .text "End";

    }

}

on End select

{

    exit ();

}

 

on dialog start

{

    W1.xleft :=WindowXPos;

    W1.ytop :=WindowYPos;

    W1.title :=WindowText;

    W1.visible :=true;

}

Profile

WindowXPos:=10;

WindowYPos:=5;

WindowText:="Out Of Profile";

Dieses Profile kann nur über DM_LoadProfile in die Applikation bzw. über -profile <Dateiname> in den Simulator geladen werden.

Siehe auch

C-Funktion DM_SaveProfile

Eingebaute Funktion loadprofile()