Dial_FlashDialog (function reference)

By October 1, 2017 November 14th, 2018 Online Help, Troi Dialog Plug-in
Troi Dialog Plug-in for FileMaker Pro


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

SyntaxFunction badge

Dial_FlashDialog ( switches ; ticks ; text )


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 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



This function always returns 0.

Originated in

Troi Dialog Plug-in 1.2


FileMaker Pro 12 to 17


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.


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


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 14 to 17 –> Dial_FlashDialog (dialp4303) 2018-1114 15:02:39