DADiSP Worksheet Functions > Function Categories > Datasets, Worksheets and Labbooks > NEWWORKSHEET

 

NEWWORKSHEET

Purpose:

Creates a new, empty Worksheet

Syntax:

NEWWORKSHEET(

numwin, verify, preserve_xy, preserve_dialog)

numwin

-

Optional. An integer. Number of Windows for the new Worksheet. If not specified, defaults to the configuration parameter: NUM_DEFAULT_WINDOWS.

verify

-

Optional. An integer, the verify flag.

0:

do not ask or save the current Worksheet.

1:

ask to save the current Worksheet if changed (default)

preserve_xy

-

Optional. An integer, the preserve coordinates flag.

0:

reinitialize Worksheet coordinates (default)

1:

preserve current Worksheet coordinate layout

preserve_dialog

-

Optional. An integer, the preserve embedded dialogs flag.

0:

remove embedded dialogs (default)

1:

preserve current Worksheet embedded dialog boxes

Returns:

1 if Worksheet created, 0 if error.

Example:

newworksheet(2)

 

creates a two Window Worksheet and prompts to save the current Worksheet if it has changed.

Example:

newworksheet(2, 0, 1, 1)

 

creates a two Window Worksheet, does not prompt to save the current Worksheet if it has changed. The current Worksheet geometry is preserved and all embedded dialog boxes are also preserved.

See Also:

EXPORTWORKSHEET

IMPORTWORKSHEET

REMOVEWINDOW

SAVEWORKSHEET