f$Dialog

Aufruf eines benutzerdefinierten Dialoges. Das Dialogfenster muss dabei zuvor mit dem ePOS-Dialog-Editor erstellt sein. Ein Überblick über in ePOS verfügbaren Dialogtechniken ist unter der Ansteuerung von Dialogen und Dialogfeldern zu finden.

Bevor der Dialog auf dem Bildschirm angezeigt wird, werden zunächst alle Dialogfelder mit den aktuellen Parameterwerten gefüllt (siehe dazu auch den Parameteraustausch von Dialogen mit der Logik).

Rückgabewert der Funktion f$Dialog ist der Rückgabewert der gedrückten Schaltfläche (ein Dialog kann nur über eine Schaltfläche beendet werden). Anhand dieses Funktionswertes kann in der Logik weiter verzweigt werden. Siehe dazu den Aufruf eines „normalen" Ein- oder Ausgabedialogs. Dort findet sich auch ein Beispiel einer kleinen Ablaufsteuerung.

In der Dialogmaske können Eingaben sofort auf ihre Korrektheit geprüft oder abhängig von einer Eingabe in einem Feld andere Felder bestimmt oder vorbelegt werden. Auch die dynamische Festlegung eines Wertevorrats für ein Kombinationsfeld ist möglich (Datenquelle).

Tipp:

Um einen kurzen Hinweis oder eine Fehlermeldung auszugeben, muss nicht unbedingt ein Dialog erstellt werden. Diese Meldungen können über f$Meldungf$Meldung (f$Message) direkt ausgegeben werden.

Syntax:	Weiter = f$Dialog( Fenstername )
	Argument	Typ	Bedeutung
	Fenstername	Zeichenkette	Name des Dialogfensters
Ergebnis:	Zeichenkette	Rückgabewert der gedrückten Schaltfläche
Beispiel:	Ablauf = f$Dialog( 'Motor' )

Hinweis:

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$Dialog.

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$Dialog anwendbare Funktionen:

f$Meldung	Ausgabe einer Meldungsbox
f$DialogOeffnen	Dynamische Feldänderungen, Arbeiten mit mehreren Fenstern
f$DialogAnzeigen	Öffnen eines Fensters zur Datenanzeige