Positioning of Dialogs on the Screen

All ePOS dialogs are centered in the middle of the screen by default. Additionally it is possible to save a special screen position in the dialog (Property save position in the dialog object dialog window). If this property is selected, the current position of the dialog on the screen is saved and during runtime the dialog will appear at that position.

Please note:

If "save position" is selected, the dialog has to be at the desired position otherwise the dialog will be saved at its current position.
When choosing the screen position, the resolution of the end users should be considered. The choice of font size in the windows control panel (e.g. "small font" or "large font") has an influence on the actual size of the window too. Should a dialog for the runtime not fit onto the screen, it is automatically moved to the visible area. Scroll bars are additionally faded in.

Saving specific screen positions should therefore be done in a targeted manner - under preference of the areas in the top left hand side of the screen.

Sensible applications for example are:

when using an additional dialog for showing data
when working with several simultaneously open screens
when integrating ePOS dialogs into other applications where certain screen areas are already in use with other applications.
when working on two monitors. In that case for instance, the dialogs can all be moved to the left hand screen.

The user can move a dialog on the screen if this window is active (in a display window (f$DisplayDialog) this is therefore not possible). This screen position remains until the dialog is closed again - so when using f$DialogOpen until the command f$DialogEnd is used.

When using f$Dialog the dialog is closed when a button is pressed. If this dialog is subsequently opened again by the logic, it will appear in the default position again. If the user had moved the dialog before pressing the button it appears that it "jumps" to another position. This effect can be avoided if f$DialogExecute is used instead of f$Dialog:

Dialog loop with possible "jump effect":

DT "Dialog"

		R 01	R 01	ELSE
B 01	Continue	...	...
B 02
	... appropriate actions ...
A ??	Continue = f$Dialog(’Example’)	x	x
A ??	p$Dialog()	x	x

Dialog loop without "jump effect":

DT "Dialog1"

		R 01	ELSE
B 01
A 01	FID = f$DialogOpen(’Example’)	x
A 02	Continue = f$DialogExecute( FID )	x
A 03	p$Dialog2()	x
A 05	f$DialogEnd( FID )	x

DT "Dialog2"

		R 01	R 01	ELSE
B 01	Continue	...	...
B 02
	... appropriate actions ...
A ??	Continue = f$DialogExecute( FID )	x	x
A ??	p$Dialog2()	x	x