86. XXE.new
Prev | Chapter 6. Commands written in the Java™ programming language | Next

## 86. XXE.new

Parameter syntax:

    [ (configuration_name template_name | '- -') [ save_file_or_URL | '-' ]? ]?

Creates a new document by copying a named template (that is, a document template which has been declared in an XXE configuration file).

Parameters:

`configuration_name`

  Specifies the name of the configuration where the template has been declared. Example: "`XHTML`".

`template_name`

  Specifies the name of the document template. Example: "`Page`".

  When `configuration_name` and `template_name` are absent or specified as "`- -`", the command displays the File|New dialog box to let the user specify a document template.

`save_file_or_URL`

  When this argument is specified as a filename or URL, the newly created document is immediately saved to specified location.

  When this argument is specified as "`-`", the command displays the file chooser dialog box to let the user specify a save location for the newly created document. After this, the newly created document is immediately saved to specified location.

  When this argument is absent, the newly created document is automatically given a save location but it is not actually saved to this location (that is, the command behaves like menu item File|New).

Returns newly created `com.xmlmind.xmledit.doc.Document` (for use by higher-level commands) or `Command.EXECUTION_FAILED` if specified template cannot be opened or if user has canceled the command.

Prev | Up | Next
85. XXE.edit | Home | 87. XXE.open