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'':
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=
suggests the same file name/file URL as the document being converted but with a "foo
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
".