Dial_SetPosition (function reference)

By October 1, 2019 October 13th, 2019 Online Help, Troi Dialog Plug-in
Troi Dialog Plug-in for FileMaker Pro

Dial_SetPosition

Sets the position on the screen of dialogs to be shown.

SyntaxFunction badge

Dial_SetPosition ( switches ; left ; top )

Parameters

switchesspecifies the scope of the SetPosition function
leftthe left co-ordinate (in pixels) of the dialog
topthe top co-ordinate (in pixels) of the dialog

Switches

Switches can be empty or must be one of these:

-Allshow all subsequent dialogs at the specified position
-Onceshow only the next dialog at the specified position

If you don’t specify a switch the position is set once. If you want to reset the position to the default position use this switch:

-Defaultshow all subsequent dialogs at the default position

Returned Result

Data type returned

Error code

Result

An error code. Currently the plug-in always returns 0.

Originated in

Troi Dialog Plug-in 3.0

Compatibility

FileMaker Pro 14 to 18

Considerations

On Mac OS the plug-in makes sure the dialog does not display under the menu bar.

Example

Set Field [ gErrorCode ; Dial_SetPosition ( "-Once" ; 100 ; 150 ) ]

This will set the position of the next dialog box to 100 pixels from the left and 150 pixels from the top of the screen.

Example 2

This example will use fields to set the position for all next dialogs. We assume that in your FileMaker file the following fields are defined:

gErrorCode     	Global, text
gLeft     	Global, text
gTop     	Global, text

Add the following script step:

Set Field [ gErrorCode ; Dial_SetPosition ( "-All " ; gLeft ; gTop ) ]

Related functionsFunction badge

Dial_Dialog
Dial_InputDialog
Dial_ListDialog

Related topics

Troi Dialog Plug-in online help (overview)


Online Help Page for Troi Dialog Plug-in for 14 to 18 –> Dial_SetPosition (dialp4316) 2019-1013 20:00:00