FbOpenDialogExtended (FB)¶

FUNCTION_BLOCK FbOpenDialogExtended EXTENDS FbOpenDialog

Handles the action open dialog with extended parameters

To use this function block in the programm set the according inputvalues and start the dialog open action with xExecute = TRUE.

InOut:

Scope	Name	Type	Initial	Comment	Inherited from
Input	`itfClientFilter`	IVisualizationClientFilter		With this filter, the clients, where the action should happen, are specified. Use standard filter from GVL Globals, e.g. `VU.Globals.CurrentClient`, or use a own implentation of the interface.	FbExecuteSingleVisuActionBase
Output	`eError`	ERROR			FbExecuteSingleVisuActionBase
Input	`sDialogName`	`STRING`		Mandatory value: name of the dialog	FbOpenDialog
	`xModal`	`BOOL`	TRUE	Optional setting for dialog usage (modal or not modal). `TRUE`: modal: only input in the dialog is possible (defaultvalue) `FALSE`: not modal: usage of visu beneath dialog is possible, too.	FbOpenDialog
	`pTopLeftPosition`	POINTER TO VisuStructPoint		Optional position to open: centered (default): use no input point on position X/Y: set values accordingly in the VisuStructPoint	FbOpenDialog
	`itfDialogOpenedListener`	`VisuElemBase.IDialogOpenedListener`		Optional: Action done listener The FB instance gets notified, when the dialog has opened.
	`pbyDialogInterfaceData`	POINTER TO BYTE		Optional: Sets the parameters for the dialog interface. Should be used together with `udiDialogInterfaceDataSize`. For each dialog automatically a structure is generated. E.g. DialogName: MessagBox –> Structure name: MessageBox_VISU_STRUCT. Use a instance of this struct, e.g. dialoginst : MessageBox_VISU_STRUCT and set it as ADR(dialoginst) for this variable
	`udiDialogInterfaceDataSize`	`UDINT`		Optional: Sets the size of the data for the dialog interface. Should be used together with `pbyDialogInterfaceData` For each dialog automatically a structure is generated. E.g. DialogName: MessagBox –> Structure name: MessageBox_VISU_STRUCT. Use SIZEOF(MessageBox_VISU_STRUCT) for this variable.
	`itfDialogCloseListener`	`VisuElemBase.IDialogCloseListener`		Optional: Dialog close listener The FB instance gets notified, when the dialog is closed.
	`pbyTagForDialogClosed`	POINTER TO BYTE		Optional: Tag/Data which is necessary for the action on dialog closed. Can only be used together with `itfDialogCloseListener` The optional parameter `itfDialogCloseListener` must implement `IDialogCloseListenerWithTag`. In `DialogClosedWithTag` it will get this parameter (`pbyTagForDialogClosed`) back as `pTag`