Skip to main content

Dial_SetPreference (function reference)

By March 1, 2025March 20th, 2025Online 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 17 to FileMaker Pro 21 (2024)

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 17 to 2024 –> Dial_SetPreference (dialp4317) 2025-0320 16:37:14

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.