Dial_SetPreference (function reference)

By October 27, 2026October 28th, 2026Online Help, Troi Dialog Plug-in
Troi Dialog Plug-in for FileMaker Pro

Dial_SetPreference

Sets preferences, like the timeout time of the progress dialog.

SyntaxFunction badge

Dial_SetPreference ( switches ; value )

Parameters

switches specifies which preference to set
value the value to set it to

Switches

Switches can be this:

-ProgressbarDefunctTicks set the time the progress bar disappears automatically in 1/60th of a second

or it can be:

-TitlesInProgressBarDialogs set to "off" to suppress titles at the top of progress bar dialogs for all next calls until FileMaker is restarted. Set to "on" to show the titles again

Returned Result

Data type returned

Error code

Result

If successful it returns 0.
If unsuccessful it returns an error code starting with $$ and the error code. Returned error codes can be:

$$-50 parameter error

Originated in

Troi Dialog Plug-in 3.5

Compatibility

FileMaker Pro 19 to FileMaker Pro 26 (2026)

Example

Set Field [ gErrorCode ; Dial_SetPreference ( "-ProgressbarDefunctTicks" ; 20*60 ) ]

This will change the time of automatic removal of a progress bar dialog to 20 seconds. When you forget to remove the ProgressBar window the plug-in removes it automatically after 30 seconds.
In some special cases you might want to change this, for example to be able to have a longer debug time.

Example 2

Set Variable [ dontCare ; Dial_SetPreference ( "-TitlesInProgressBarDialogs" ; "off" ) ]

This will suppress titles at the top of progress bar dialogs for all next calls until FileMaker is restarted.

Related functionFunction badge

Dial_ProgressBar

Related topics

Troi Dialog Plug-in online help (overview)


Online Help Page for Troi Dialog Plug-in for 19 to 26 –> Dial_SetPreference (dialp4317) 2026-1028 14:28:31

Share
troi.com
Privacy Overview

This website uses cookies so that we can provide you with the best user experience possible. Cookie information is stored in your browser and performs functions such as recognizing you when you return to our website and helping us to understand which sections of the website you find most interesting and useful.

You can adjust all of your cookie settings by navigating the tabs on the left hand side.