NewDocument

image\bltlrgss.gif Editions  image\bltlrgss.gif Related Transactions  image\bltlrgss.gif Example

The NewDocument transaction creates a new, blank document window with the specified label and file name.

Type XTYP_REQUEST or XTYP_EXECUTE

Syntax [NewDocument("documentlabel", "fileName")]

Parameter

Data type

Meaning

documentlabel

string

label, maximum 80 characters

fileName

string

file name including path to assign

Reply

Data type

Values

Meaning

count

WORD

0 | 1

number of documents created

docwinID

DWORD

identifier of the new document

Remarks

Calling this transaction does not create a page. To create a page, you must add a layer or page to the document with the NewLayer, NewPage, ImportLayer, or ImportPage transaction. The new or imported item will be given the file name specified. The label will be assigned as a page label.

Replies are only returned when this transaction is called as an XTYP_REQUEST.

Release information

Added in Release 3.50.

See also

Creating a document

Defining window titles