f$Dialog

Call a user-defined dialog. The dialog window must have been created beforehand with the ePOS dialog editor. An overview of the dialog technologies available in ePOS can be found under Management of dialogs and dialog fields.

Before the dialog is displayed on the screen, all dialog fields are first filled with the current parameter values.

The return value for the f$Dialog function is the return value for the button pressed (a dialog can only be closed through a button). Further branching is possible by using the value of this function. See Call a "normal" input or output dialog for this. There is also an example of a small sequence control there.

Entries can be immediately checked for their correctness in the dialog screen or, depending on an entry in another array, other arrays can be specified or preallocated. It is also possible to dynamically determine value inventories for a combination array (data source).

Hint:

You do not necessarily have to create a dialog in order to produce a short advisory or error message. These messages can be produced directly via f$Message.

Syntax:	Next = f$Dialog( DlgName )
	Argument	Type	Meaning
	DlgName	String	Name of the dialog window
Result:	String	Return value of the button pressed
Example:	Process = f$Dialog( 'Motor' )

Note:

If an error message referring to an undefined parameter appears on the screen while calling a function, then this is probably a parameter within the dialog window. If the verification of the DT also finds an error, the cause is either an incorrect function argument (dialog name) or the return value of the f$Dialog function.

Functions that can be used instead of f$Dialog:

f$Message	Output of a message box
f$DialogOpen	Dynamic array updates, work with multiple windows
f$DisplayDialog	Open a window for showing data