Skip to main content

Dial_SetPreference (function reference)

By November 1, 2020November 18th, 2021Online 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 16 to 19

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 16 to 19 –> Dial_SetPreference (dialp4317) 2021-1118 20:39:14