Troi Dialog Plug-in > Functions reference > Dial_SetPreference
 |
Dial_SetPreference |
Sets preferences, like the timeout time of the progress dialog.
Syntax
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 function
| Dial_ProgressBar |
Related topics
Troi Dialog Plug-in online help (overview)
