80. selectConvertedFile
Prev | Chapter 6. Commands written in the Java™ programming language | Next

## 80. 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`".

Prev | Up | Next
79. selectFile | Home | 81. selectLink