f$DialogOeffnen (f$DialogOpen)
f$DialogOeffnen (f$DialogOpen)
Öffnen eines Dialogfensters. Das Fenster wird auf dem Bildschirm mit den aktuellen Daten angezeigt, aber nicht aktiviert (d.h. es sind (noch) keine Eingaben möglich). Übergeben wird der Dialogname, zurückgegeben wird eine Identifikationsnummer, unter der das Fenster in späteren Funktionsaufrufen angesprochen wird.
Hinweis: Dies ist eine Expertenfunktion, die für anspruchsvolle Anwendungen gedacht ist. Für Normalfälle sollte die Funktion f$Dialog verwendet werden.
Im Unterschied zu f$Dialog und f$DialogAnzeigen wird ein Dialog mit f$DialogOeffnen geöffnet, um
einzelne Dialogfeld-Eigenschaften aus der Entscheidungstabelle heraus dynamisch verändern zu können, z.B. ein Dialogfeld sichtbar oder unsichtbar zu setzen.
den Dialog aus der Entscheidungstabelle heraus gezielt aktivieren zu können. Dadurch wird ein Arbeiten in mehreren Fenstern möglich, die gleichzeitig auf dem Bildschirm dargestellt werden.
Es ist möglich, gleichzeitig bis zu 20 Dialoge zu öffnen. Die Positionen dieser Dialoge am Bildschirm werden über die an den Dialogen gespeicherten Positionen bestimmt. Sie müssen daher sorgfältig aufeinander abgestimmt werden. Ein Verschieben eines Fensters kann nur durch den Anwender geschehen, und auch das nur, wenn dieses Fenster gerade aktiv ist, d.h. die Eingaben annimmt. Die Aktivierung eines Fensters erfolgt ausschließlich über die Entscheidungstabelle (mit f$DialogStarten).
Es können prinzipiell auch mehrere Dialoge mit demselben Dialognamen gleichzeitig geöffnet werden, da die Dialoge im Folgenden immer durch die Identifikationsnummer (Rückgabewert dieser Funktion) angesprochen werden. Allerdings liegen diese Dialoge dann am Bildschirm übereinander.
Bitte beachten:
Die dargestellten Daten in einem inaktiven Dialog werden nicht automatisch aktualisiert, sondern erst, wenn der Dialog aktiviert wird (mit f$DialogStarten). Sollen die Daten in einem inaktiven Dialog aktualisiert werden, so muss dieser Dialog mit f$DialogAnzeigen statt mit f$DialogOeffnen geöffnet worden sein.
Ein über f$DialogOeffnen geöffneter Dialog wird über f$DialogBeenden (oder automatisch bei Ende der Logik) wieder geschlossen.
Die Funktion f$DialogOeffnen kann direkt aus einer Überprüfungslogik (Kontroll ET) heraus verwendet werden. Allerdings wird beim anschließenden f$DialogStarten der Dialog, der die Überprüfungslogik gestartet hat inaktiv gesetzt, bis der nun aktive Dialog wieder beenden wird.
Syntax: | FensterID = f$DialogOeffnen( Dialogname[,Sichtbar] [,Modus] ) | ||
| Argument | Typ | Bedeutung |
| Dialogname | Zeichenkette | Name des anzuzeigenden Dialogs |
| Sichtbar | Ganzzahl | Dieser Parameter steuert, ob der Dialog sofort sichtbar sein soll. Wird 0 angegeben, ist der Dialog erst beim Befehl f$DialogStarten bzw. f$Aktionsdialog sichtbar. Wird 1 angegeben oder der Parameter weggelassen, ist er sofort sichtbar. |
| Modus | Ganzzahl | Art der Dialogdarstellung: 0 – normal, 1- mit inaktivem Schließen Button |
Ergebnis: | Ganzzahl | Identnummer des geöffneten Fensters | |
Beispiel: | ID = f$DialogOeffnen( 'Auftragsdaten',1) | ||
Bitte beachten:
Falls bei Aufruf der Funktion auf dem Bildschirm eine Fehlermeldung erscheint, die auf einen nicht definierten Parameter hinweist, so ist dies wahrscheinlich ein Parameter innerhalb des Dialogfensters. Wenn die Freigabe der ET ebenfalls einen Fehler findet, ist die Ursache ein falsches Funktionsargument (Dialogname) oder der Rückgabewert der Funktion f$DialogOeffnen.
Siehe weiter (insbesondere auch zusammenhängende Beispiele):
Ansteuerung von Dialogen und Dialogfeldern
Arbeiten mit mehreren gleichzeitig geöffneten Dialogen
Positionierung von Dialogen auf dem Bildschirm
Anstelle von f$DialogOeffnen anwendbare Funktionen:
Bearbeitung „einfacher" f$Dialog Dialoge | |
Öffnen eines Fensters zur Datenanzeige |
Nach Ausführung von f$DialogOeffnen anwendbare Funktionen:
Aktivieren eines Dialoges über ID | |
Aktivieren eines geöffneten Dialogs (über ID) ohne Rückgabe | |
Schließen eines Dialoges über ID | |
Dialogfeld sichtbar/unsichtbar setzen, aktivieren | |
Dialogfeld-Beschriftung setzen | |
Setzen weiterer Dialogfeld-Eigenschaften | |
Text-Eigenschaft aus Dialogobjekt lesen | |
numerische Eigenschaft aus Dialogobjekt lesen |