Dial_SetPreference (function reference)

By October 1, 2017 November 14th, 2018 Online 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

switchesspecifies which preference to set
valuethe value to set it to

Switches

Switches can be this:

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

or it can be:

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

$$-50parameter error

Originated in

Troi Dialog Plug-in 3.5

Compatibility

FileMaker Pro 12 to 17

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 14 to 17 –> Dial_SetPreference (dialp4317) 2018-1114 15:11:11