IDMDigitizer Interface

Version: 2.0
Dispatch interface for DMDigitizer Control

GUID: {673AAF10-9A0B-11D4-B2A4-FD6847C75367}

This interface implemented by specialized DMDigitizer ActiveX control. Use MouseMode property to select DrawFrame, Add, Delete or Edit points mode, Container property to read points coordinates, and Min, Max properties to set coordinates ranges. See also DMDigitizer test page.

Members:
Kind Name ID Description
IsVisible 101 Change control visibility
Color -501 Change control color
Enabled -514 Enable or disable control
Container 102 Return point container object
Clear 103 Clear digitizer picture
PasteFromClipboard 104 Paste digitizer picture from the clipboard
CanPaste 105 True if PasteFromClipboard is possible
Load 106 Load digitizer picture from the disk file
MouseMode 107 Change digitizer mode
XMin 108 Change minimum X coordinate
XMax 109 Change maximum X coordinate
YMin 110 Change minimum Y coordinate
YMax 111 Change maximum Y coordinate

Syntax:
property IsVisible: Boolean

Applies to:
CoCPortLib2, CPortLibX2, DMAxis, DMClientSocket, DMComboBox, DMComPort, DMComTerminal, DMDigitizer, DMExpressionComboBox, DMFloatEdit, DMIEEE488Port, DMLabel, DMListBox, DMSerie, DMSpinEdit

IsVisible property determines whether appropriate object is visible on the screen. Note that for ActiveX controls embedded in the HTML page, you can also change Object.style.visibility property. Some controls like DMClientSocket, DMIEEE488Port and DMComPort are invisible by design and don't implement this property.

Syntax:
property Color: User_Defined

Applies to:
DMAxis, DMComboBox, DMDigitizer, DMExpressionComboBox, DMFloatEdit, DMLabel, DMListBox, DMPlot, DMSerie, DMSpinEdit, DMWorksheet

This property should be used to change color of the selected object.

Syntax:
property Enabled: Boolean

Applies to:
DMComboBox, DMDigitizer, DMExpressionComboBox, DMFloatEdit, DMListBox, DMSpinEdit

Enabled property determines whether appropriate ActiveX control is in interactive state (i.e. respond to mouse clicks and key events) or not. Disabled control often displayed with gray font color.

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:
function Clear: VOID

Applies to:
B740X, DMContainer, DMDigitizer, DMDigitizerContainer, DMLabels, DMListItems, DMNotes, DMStrings, E712X, HP4191X

For DMContainer and DMDigitizerContainer objects, Clear method empties the container and set Modified property to True.

For DMDigitizer, this method clears digitizer picture.

For DMListItems, DMNotes and DMStrings Clear also empties the contents of the appropriate Items (or Lines) arrays.

For HP4191X, B740X and E712X this method initialize appropriate device into some predefined state.

For DMLabels, this method deletes all plot labels.

Syntax:
function PasteFromClipboard: VOID

Applies to:
DMDigitizer, DMLabel, DMNotes, DMPlot, DMSerie, DMWorksheet

For DMDigitizer, this method inserts into the digitizer control the picture from the clipboard.

For DMNotes, PasteFromClipboard operates like in any text editor.

For DMSerie, PasteFromClipboard has a parameter. If DataOnly=True, visual attributes like colors, point size etc. are not assigned. Keep in mind that this method can correctly paste only series copied from the same instance of DM, because it performs search to assign Container.

For DMLabel, this method is just a pair for CopyToClipboard. In addition, Rectangle - type label can paste (and display) metafiles (and bitmaps).

For DMPlot, PasteFromClipboard has Mode parameter that determines what data will be pasted; possible values defined in the PlotCopyModes enumeration. Certainly, only series and labels (or both) may be pasted; new objects are created and initialized by data from the clipboard.

For DMWorksheet, this method also has a parameters. Text in the clipboard must contain lines of values separated by spaces, commas or tabstops. Data is pasted from topleft selected cell. If InsertLines is true, new lines will be added, else existing lines will be modified according to second parameter. If Overwrite mode specified, cell contents are replaced else data from clipboard will be inserted at selected position.

For all objects, this method does nothing if there's no suitable data on the clipboard. Use CanPaste method to determine whether clipboard has appropriate data formats.

Syntax:
function CanPaste: Boolean

Applies to:
DMApplication, DMDigitizer, DMInternalApplication, DMLabel, DMNotes, DMPlot, DMSerie, DMWorksheet

CanPaste method returns True if clipboard has valid data for PasteFromClipboard method. Use it to monitor controls associated with "Paste" command. Notice: for IDMApplication3 interface, this method has a parameter whose value allows to test whether desirable clipboard format is available.

Syntax:
function Load(FileName): VOID

Applies to:
DMContainer, DMDigitizer, DMDigitizerContainer, DMLabel, DMNotes

Load method allows you to load data from the disk file into the object. For DMContainer, text-type (ASCII) file must contain values separated by commas, tabstops or spaces. For DMDigitizerContainer, however, this method not supported. As of build #415, compressed data format (binary) was added.

DMDigitizer.Load should be used to load picture into the digitizer. DMNotes.Load just loads text into the Notes editor. DMLabel uses Load() member to copy images in various formats (ico, bmp, jpg, gif, png) into the metafile.

For DMContainer, DMLabel and DMNotes objects, this method also can handle HTTP and FTP URLs, so that you can download files located on the Internet/Intranet.

Syntax:
property MouseMode: User_Defined

Applies to:
DMDigitizer, DMPlot

MouseMode property for DMDigitizer control select one of the following Digitizer modes: Draw axes frame, Add, Delete or Edit points. Only subset of constants listed in PlotMouseModes enumeration is supported.

For DMPlot, all constants except pmmAddPoints are valid. Use this property to set plot reaction on the mouse clicks programmatically.

Syntax:
property XMin: Double

Applies to:
DMDigitizer, DMLabel

Syntax:
property XMax: Double

Applies to:
DMDigitizer, DMLabel

Syntax:
property YMin: Double

Applies to:
DMDigitizer, DMLabel

Syntax:
property YMax: Double

Applies to:
DMDigitizer, DMLabel