Skip to main content

Methoden des Dialogmanagers

Visualisierungen, die den Visualisierungstyp Dialog haben und als Eingabeaufforderung dienen, werden automatisch instanziiert 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.

Wichtig

Sie können die Methodenaufrufe in Funktionsbausteinen oder Funktionen porgrammieren, die ihrerseits 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.

GetDialog

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

Tabelle 677. VAR_INPUT

Name

Datentyp

Beschreibung

stName

STRING

Name des Dialogs



Tabelle 678. VAR_OUTPUT

Name

Datentyp

Beschreibung

GetDialog

VisuElems.IVisualisationDialog

Instanz (IVisualisationDialog) des Dialogs



GetClientInterface

Liefert einen Pointer auf die Dialogstruktur.

Tipp

Für jede Darstellungsvariante werden jeweils Dialogdaten gehalten.

Tabelle 679. VAR_INPUT

Name

Datentyp

Beschreibung

dialog

VisuElems.IVisualisationDialog

Name der Visualisierung

pClient

POINTER TO VisuElems.IVisualisationDialogVisuStructClientData

Pointer auf die Darstellungsvariante



Tabelle 680. VAR_OUTPUT

Name

Datentyp

Beschreibung

GetClientInterface

Beispiel: POINTER TO Login_VISU_STRUCT

Pointer auf die Dialogstruktur



OpenDialog

Öffnet den Dialog für den Client.

Tipp

Daneben gibt es die erweiterte Methode OpenDialog(Nummer).

Tabelle 681. VAR_INPUT

Name

Datentyp

Beschreibung

dialog

VisuElems.IVisualisationDialog

Name der Visualisierung

pClient

POINTER TO VisuElems.VisuStructClientData

bModal

BOOL

pRect

POINTER TO



Tabelle 682. VAR_OUTPUT

Name

Datentyp

Beschreibung

OpenDialog



CloseDialog

Schließt den Dialog für den Client.

Tabelle 683. VAR_INPUT

Name

Datentyp

Beschreibung

dialog

VisuElems.IVisualisationDialog

Dialogobjekt wie von GetDialog erhalten

pClient

POINTER TO VisuElems.VisuStructClientData



Tabelle 684. VAR_OUTPUT

Name

Datentyp

Beschreibung

CloseDialog



CloseDialog2

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

Tabelle 685. 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.



Tabelle 686. VAR_OUTPUT

Name

Datentyp

Beschreibung

CloseDialog2