Displays a flash dialog box for a specified period of time.
Dial_FlashDialog ( switches ; ticks ; text )
|switches||(optional) this changes the behaviour of the dialog|
|ticks||the time this dialog must be visible, in 1/60th of a second|
|text||specifies the text you want to display|
Switches can be empty or one of these:
|-NoteIcon||shows a note icon (indicating this dialog gives the user information)|
|-CautionIcon||shows a caution icon (indicating this dialog warns the user)|
|-StopIcon||shows a stop icon (indicating this is something severe which the user needs to address )|
|-CustomIcon||shows a custom icon. This icon needs to be set before with the Dial_IconControl function|
You can also add this switch:
|-IconSize=48||display the icon at 48×48 pixels|
Data type returned
This function always returns 0.
Troi Dialog Plug-in 1.2
FileMaker Pro 12 to 16
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.
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 script step
|Show Flash Dialog|