SetFileSaveDlgTitle

SetFileSaveDlgTitle

The SetFileSaveDlgTitle function changes the title of all subsequent Save As dialogs. The change persists until the function is called again or the script ends.

Syntax

SetFileSaveDlgTitle( sTitle )

where sTitle is a string to be used as the new title.

Remarks

Before setting the title using this method, is may be useful to fetch the current title using the companion GetFileSaveDlgTitle. This allows the dialog title to be restored. For example, you may specify the type of file to open in the dialog title during one use, then restore the title to "Save" afterward.

Example

This script sets the dialog title on 2 occasions, then restores it to the default.

sOldTitle = GetFileSaveDlgTitle()	-- fetch the original title
SetFileSaveDlgTitle("Save Image 1")	-- set a new title
sName1 = GetFileName()	-- uses the new title
...
SetFileSaveDlgTitle("Save Image 2")	-- change the title again
sName2 = GetFileName()	-- uses the second title
...
SetFileSaveDlgTitle(sOldTitle)	-- restore the original title