73. selectConvertedFile

Variant of command selectFile specially designed to be used in Convert macro-commands such as docb.convertToHTML1, xhtml.convertToPS, etc.

Unlike command selectFile, this command is aware of the document being converted, which allows it to suggest smarter save file names/file URLs.

Moreover, this command supports two more ``modes'':

saveFileWithExtension=file extension, saveFileURLWithExtension=file extension

Identical to mode saveFile [saveFileURL], except that, when no URL_template has been specified,

  • saveFile suggests the same file name/file URL as the document being converted, but with an "out" extension.

  • saveFileWithExtension=foo suggests the same file name/file URL as the document being converted but with a "foo" extension.

File extension must not be empty, must not start with a '.' and must not contain spaces or '.'.

Examples:

selectConvertedFile
selectConvertedFile saveFile
selectConvertedFile [Convert to WordML]saveFileWithExtension=wml
selectConvertedFile [Choose An Icon] openFileURL http://www.acme.com/doc/images/logo.gif
selectConvertedFile saveFileURLWithExtension=ps file:///tmp/article.pdf

Note that when an URL_template has been specified, this URL_template is always suggested as is by the dialog box. For example, "selectConvertedFile saveFileURLWithExtension=ps file:///tmp/article.pdf" will suggest "file:///tmp/article.pdf" as a save file URL, and not "file:///tmp/article.ps".