Dial_SetDialogTitle (function reference)

By October 1, 2017 November 14th, 2018 Online Help, Troi Dialog Plug-in
Troi Dialog Plug-in > Functions reference > Dial_SetDialogTitle
Troi Dialog Plug-in for FileMaker Pro

Dial_SetDialogTitle

Sets the default dialog title for the title bar of dialogs.

SyntaxFunction badge

Dial_SetDialogTitle ( switches ; dialogTitle )

Parameters

dialogTitlethe title of the dialog that you want to use for all subsequent dialogs

Returned Result

Data type returned

Error code

Result

An error code. Currently the plug-in always returns 0.

Originated in

Troi Dialog Plug-in 2.1

Compatibility

FileMaker Pro 12 to 17

Considerations

The title will stay the same for all following dialogs until you change it again or restart FileMaker. If you add this function to your startup script, all dialogs with a title bar will show the title you’ve given.

NOTE On Mac OS all dialogs except the list dialog have no title bar. This function has no effect for these title bar-less dialogs.

Example

Dial_SetDialogTitle ( "-Unused" ; "Troi's Dialog Demo Solution" )

This will set the title of subsequent dialogs to “Troi’s Dialog Demo Solution”.

Example 2

We assume that in your FileMaker file the following fields are defined:

gDialogTitle		Global, text
gResult     		Global, text

Add the following script step:

Set Field [ gResult ; Dial_SetDialogTitle ( "-Unused" ; gDialogTitle ) ]

This script will use the contents of the global text field to set the dialog title.

Related functionsFunction badge

Dial_BigInputDialog
Dial_Dialog
Dial_InputDialog
Dial_ListDialog

Related topics

Troi Dialog Plug-in online help (overview)


Online Help Page for Troi Dialog Plug-in for 14 to 17 –> Dial_SetDialogTitle (dialp4311) 2018-1114 15:08:30