Methoden des Dialogmanagers

Visualisierungen, die den Visualisierungstyp „Dialog“ haben und als Eingabeaufforderung dienen, werden automatisch instanziert und vom internen Dialogmanager verwaltet.

In der Applikation kann auf den Dialogmanager über den ebenfalls internen Visualisierungsmanager zugegriffen werden, indem die Methode ‎GetDialogManager‎ aufgerufen wird.

Der Dialogmanager verfügt über die folgenden Methoden, die der Handhabung eines Dialogs dienen.

HINWEIS

Sie können die Methodenaufrufe in Funktionsbausteinen oder Funktionen porgrammieren, die selber aus der Visualisierung heraus über die Aktion ‎ST-code ausführen‎ aufgerufen werden.

Außerdem können Sie die Methodenaufrufe im Applikationscode programmieren. Achten Sie darauf, dass der Aufruf in der ‎VISU_TASK‎ läuft. Wenn das nicht der Fall ist, ist das Verhalten undefiniert.

Siehe auch

linktarget doesn't exist but @y.link.required='true'

Methode 'GetDialog'

Liefert die Instanz (‎IVisualisationDialog‎) des Dialogs, dessen Namen übergeben wird.

Tab. 680: Eingänge (VAR_INPUT)
Name	Datentyp	Beschreibung
`‎stName‎`	`‎STRING‎`	Name des Dialogs

Tab. 681: Ausgänge (VAR_OUTPUT)
Name	Datentyp	Beschreibung
`‎GetDialog‎`	`‎VisuElems.IVisualisationDialog ‎`	Instanz (`‎IVisualisationDialog‎`) des Dialogs

Methode 'GetClientInterface'

Liefert einen Pointer auf die Dialogstruktur.

Für jede Darstellungsvariante werden jeweils Dialogdaten gehalten.

Tab. 682: Eingänge (VAR_INPUT)
Name	Datentyp	Beschreibung
`‎dialog‎`	`‎VisuElems.IVisualisationDialog‎`	Name der Visualisierung
pClient	`‎POINTER TO VisuElems.IVisualisationDialogVisuStructClientData‎`	Pointer auf die Darstellungsvariante

Tab. 683: Ausgänge (VAR_OUTPUT)
Name	Datentyp	Beschreibung
`‎GetClientInterface‎`	Beispiel: `‎POINTER TO Login_VISU_STRUCT‎`	Pointer auf die Dialogstruktur

Methode 'OpenDialog'

Öffnet den Dialog für den Client.

Daneben gibt es die erweiterte Methode 'OpenDialog(Nummer)' .

Tab. 684: Eingänge (VAR_INPUT)
Name	Datentyp	Beschreibung
`‎dialog‎`	`‎VisuElems.IVisualisationDialog‎`	Name der Visualisierung
`‎pClient‎`	`‎POINTER TO VisuElems.VisuStructClientData‎`
`‎bModal‎`	`‎BOOL‎`
`‎pRect‎`	`‎POINTER TO‎`

Tab. 685: Ausgänge (VAR_OUTPUT)
Name	Datentyp	Beschreibung
`‎OpenDialog‎`

Methode 'CloseDialog'

Schließt den Dialog für den Client.

Tab. 686: Eingänge (VAR_INPUT)
Name	Datentyp	Beschreibung
`‎dialog‎`	`‎VisuElems.IVisualisationDialog‎`	Dialogobjekt wie von `‎GetDialog‎` erhalten
`‎pClient‎`	`‎POINTER TO VisuElems.VisuStructClientData‎`

Tab. 687: Ausgänge (VAR_OUTPUT)
Name	Datentyp	Beschreibung
`‎CloseDialog‎`

Methode 'CloseDialog2'

Schließt den Dialog für den Client. Erweiterung der Methode ‎CloseDialog‎.

Tab. 688: Eingänge (VAR_INPUT)
Name	Datentyp	Beschreibung
`‎dialog‎`	`‎VisuElems.IVisualisationDialog‎`	Dialogobjekt wie von `‎GetDialog‎` erhalten
`‎pClient‎`	`‎POINTER TO VisuElems.VisuStructClientData‎`
`‎DialogFlags‎`	`‎DWORD‎`	Angabe möglicher Optionen für das Schließen der Dialoge. Relevant sind nur die Werte 0 (Verhalten wie `‎CloseDialog‎`) sowie 16#40, falls ein Dialog auf allen verbundenen Clients geschlossen werden soll.

Tab. 689: Ausgänge (VAR_OUTPUT)
Name	Datentyp	Beschreibung
`‎CloseDialog2‎`