Dial_FlashDialog (function reference)

Troi Dialog Plug-in for FileMaker Pro

Dial_FlashDialog

Displays a flash dialog box for a specified period of time.

SyntaxFunction badge

Dial_FlashDialog ( switches ; ticks ; text )

Parameters

switches(optional) this changes the behaviour of the dialog
ticksthe time this dialog must be visible, in 1/60th of a second
textspecifies the text you want to display

Switches

Switches can be empty or one of these:

-NoteIconshows a note icon (indicating this dialog gives the user information)
-CautionIconshows a caution icon (indicating this dialog warns the user)
-StopIconshows a stop icon (indicating this is something severe which the user needs to address )
-CustomIconshows a custom icon. This icon needs to be set before with the Dial_IconControl function

You can also add this switch:

-IconSize=48display the icon at 48×48 pixels

Returned Result

Data type returned

Number

Result

This function always returns 0.

Originated in

Troi Dialog Plug-in 1.2

Compatibility

FileMaker Pro 12 to 16

Considerations

You can hold flash dialogs on the screen longer, or get rid of them early. This is what is possible:

– To dismiss a flash dialog: click on the dialog or press the ENTER or SPACE key.
– To keep a flash dialog longer on the screen: click on the dialog and hold the mousebutton down. Or keep the ENTER or SPACE key down. When you release the mousebutton or key the dialog goes away.

IMPORTANT: Use only in a script. Do not use this function in a calculated field definition, because when FileMaker calculates the fields, this will result into a repeated dialog for EACH record.

Example

Set Field [ gResult ; Dial_FlashDialog ( "-Unused" ; 120 ; "Have a nice day" ) ]

This will show a flash dialog box for 120 ticks = 2 seconds.

Example 2

We assume that in your FileMaker file the following fields are defined:

gDialogText		Global, text
gTicksPrefs		Global, text
result     		Global, text

The gDialogText field contains the text you want to display, and can be filled for example with a calculation. gTicksPrefs should be filled with a time in 1/60th of a second. You can then use this as a preference. Add the following script step:

Set Field [ result ; Dial_FlashDialog ( "-NoteIcon" ; gTicksPrefs ; gDialogText ) ]

This shows a flash dialog with the text and a note icon.

Related functionFunction badge

Dial_IconControl

Related script stepScript step badge

Show Flash Dialog

Related topics

Troi Dialog Plug-in online help (overview)


Online Help Page for Troi Dialog Plug-in for 12 to 16 –> Dial_FlashDialog (dialp4303) 2017-1022 18:55:52