Syntax:

property WindowCaption: BSTR

Applies to:
DMDocument

Changes window title (or caption). Don't mix window caption and the file name, associated with data container object!

Syntax:

property WindowState: User_Defined

Applies to:
DMDocument

This property controls window view. It can have one of the values listed in the WindowStates enumeration. Do not mix this property with WindowSize that reflects "size" state!

Syntax:

r/o property Container: IDispatch

Applies to:
DMDigitizer, DMDocument, DMSerie

For DMDocument and DMSerie objects, Container property returns reference to the associated DMContainer object. Notice that for DMSerie object, this property is read/write, that is, you can assign to it container of any document.

For DMDigitizer, this property returns reference to the DMDigitizerContainer object, which is used only to store points coordinates.

Syntax:

r/o property Worksheet: IDispatch

Applies to:
DMDocument

Returns reference to the DMWorksheet object.

Syntax:

r/o property Plot: IDispatch

Applies to:
DMDocument

Returns reference to the DMPlot object.

Syntax:

property IsRecording: Boolean

Applies to:
DMDocument, DMSerie

For DMDocument, this property indicates whether appropriate data window is in the "recording" state, that is, used for recording data from the measurement system (or for another real-time data streaming). Such window has a thick colored frame. Besides, "recording" data window is not only a visual feedback - it doesn't refresh plot when you set Container.Modified=true, and doesn't refresh Series Manager when you set Container.Modified=false (although worksheet updates its size). This feature should be used to eliminate flickers and significantly increase data streaming rates (and reduce CPU load). In addition, value of this property analyzed in the IDMApplication.RecordPoint() method.

For DMSerie, this property reflects the fact that this series is used to display accumulated data. When it is set to True, a little cross is displayed at the last point. Set IsRecording property to indicate that you are adding points into this series.

Syntax:

function Activate: VOID

Applies to:
DMDocument

Only one of MDI child windows may be active, that is, has input focus. This procedure makes document window active. Note that activation can change index of document in the Documents property.

Example:

dim Doc
set Doc=Server.Documents(1)
Doc.Activate

Syntax:

function Close: VOID

Applies to:
CoCPortLib2, CPortLibX2, DMClientSocket, DMComPort, DMComTerminal, DMDLLHelper, DMDocument, DMIEEE488Port

For DMDocument, this procedure closes document window. It is similar to Window|Close menu command.

For DMIEEE488Port, DMClientSocket, DMComPort and DMComTerminal, Close method closes the appropriate communication port.

DMDLLHelper.Close unloads DLL so that all subsequent API calls become impossible.

Syntax:

function SaveUndoInfo: VOID

Applies to:
DMDocument

This method implemented only for backward compatibility with DM2000. Use SaveUndo() method instead, since it allows you to indicate which operation have modified data.

Syntax:

property WindowSize: User_Defined

Applies to:
DMDocument

This property controls window size. It can have one of the values listed in the WindowSizes enumeration. Do not mix this property with WindowState that reflects "view" state!

Syntax:

function CanUndo: Boolean

Applies to:
DMDocument, DMNotes

This method returns True if Undo operation for given object is possible. Use it to monitor controls associated with the "Undo" command.

Syntax:

function Undo: VOID

Applies to:
DMDocument, DMNotes

Performs Undo operation for the given object, that is, restore data to the previous state.

For DMDocument object, you should explicitly copy undo information using the SaveUndo() method before you start to change data in the container. Keep in mind that this method restores only data, so that, series ranges may change if you, for example, delete some lines.

Syntax:

function Clone(Data): IDispatch

Applies to:
DMDocument

Makes a copy of the selected data window and returns reference to its DMDocument object. If Data parameter is false, Container's data will not be copied into new window.

Syntax:

function SaveUndo(Operation): VOID

Applies to:
DMDocument

This method simply copies contents of data container into another container - Undo Buffer. It is recommended that you will call SaveUndo before any data changes, especially if you modify a range of lines simultaneously. Operation parameter will be displayed in the statusline hint for the "Undo" command.