IDMLabel interface provides access to the methods and properties of DMLabel object. You use this interface to change label text and position, read and modify its numerous visual attributes. In addition, you may copy or paste individual objects on the clipboard and programmatically select labels.
|Text||0||Change label text|
|IsVisible||1||Control label visibility|
|LabelKind||2||Change visual label style|
|XAxis||3||Change X axis (top or bottom)|
|YAxis||4||Change Y axis (left or right)|
|XMin||5||Change TPlotLabel.X1 coordinate|
|XMax||6||Change TPlotLabel.X2 coordinate|
|YMin||7||Change TPlotLabel.Y1 coordinate|
|YMax||8||Change TPlotLabel.Y2 coordinate|
|Font||-512||Change label font|
|LineType||9||Change label pen (line) type|
|LineWidth||10||Change label pen (line) width|
|Color||-501||Change label pen (line) color|
|LabelColor||11||Change label background color|
|Document||12||Returns owner document object|
|CopyToClipboard||13||Copies label object to the clipboard|
|PasteFromClipboard||14||Paste label object from the clipboard|
|CanPaste||15||True if clipboard has label object|
|Select||16||Selects label (in label edit mode only)|
|Move||17||Changes label coordinates|
|property Text: BSTR|
For DMForms ActiveX controls (DMComboBox, DMExpressionComboBox, DMListBox, DMFloatEdit, DMSpinEdit) this property changes the text in the appropriate control.
For collection objects (DMListItems, DMStrings), this property represents the contents of the collection as a single block of text. Lines are separated by standard CRLF characters.
For DMNotes, this property also operates with the editor's data as a whole.
For DMSerie and DMLabel objects, Text is just a label.
For device driver ActiveX controls (HP4191X, B740X and E712X) this property should be used to read and write data from/to the device.
|property IsVisible: Boolean|
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.
|property LabelKind: User_Defined|
This property determines label kind. Possible values are listed in the PlotLabelType enumeration.
|property XAxis: IDispatch|
For DMPlot, XAxis returns reference to the DMAxis object that represents bottom plot axis.
For DMSerie and DMLabel, XAxis property returns reference to the DMAxis object and allows you to change horizontal axis associated with given label or series (which is used to introduce coordinate system for rendering series points or label object).
dim Plt set Plt=Server.ActiveDocument.Plot Plt.CurrentSerie.XAxis=Plt.XAxis2 Plt.Labels(0).XAxis=Plt.XAxis2
|property YAxis: IDispatch|
For DMPlot, YAxis returns reference to the DMAxis object that represents left plot axis.
For DMSerie and DMLabel, YAxis property returns reference to the DMAxis object and allows you to change vertical axis associated with given label or series (which is used to introduce coordinate system for rendering series points or label object).
dim Plt set Plt=Server.ActiveDocument.Plot Plt.CurrentSerie.YAxis=Plt.YAxis2 Plt.Labels(0).YAxis=Plt.YAxis2
|property Font: PTR|
This property should be used to change font of the selected object. It returns reference to the special IFontDisp interface pointer. See Microsoft OLE documentation for more details.
|property LineType: User_Defined|
This property determines line type. Possible values listed in the PlotLineType enumeration.
|property Color: User_Defined|
This property should be used to change color of the selected object.
|property LabelColor: User_Defined|
|r/o property Document: IDispatch|
Document property returns DMDocument object which is an owner of the given object. So that, you don't need to cycle through the object collections to determine the object's owner. Keep in mind that in DM, VCL objects may be destroyed while appropriate COM objects still alive since their lifecycle is governed by reference counting mechanism. Such COM objects with killed VCL owner become a "zombie" - they have no actual data, their methods do nothing and properties return empty data.
sub TestSerie dim Serie if Server.ActiveDocument is Nothing then MsgBox "NULL document" else set Serie=Server.ActiveDocument.Plot.CurrentSerie MsgBox Serie.Document.WindowCaption end if end sub sub TestAxis dim Axis set Axis=Server.ActiveDocument.Plot.XAxis2 MsgBox Axis.Document.WindowCaption end sub sub TestContainer dim Container set Container=Server.ActiveDocument.Container MsgBox Container.Document.WindowCaption end sub sub TestPlot dim Plot set Plot=Server.ActiveDocument.Plot MsgBox Plot.Document.WindowCaption end sub sub TestWorksheet dim Worksheet set Worksheet=Server.ActiveDocument.Worksheet MsgBox Worksheet.Document.WindowCaption end sub dim Worksheet1 set Worksheet1=Server.ActiveDocument.Worksheet sub TestWorksheet1 MsgBox Worksheet1.Document.WindowCaption end sub dim Serie1 set Serie1=Server.ActiveDocument.Plot.CurrentSerie sub TestSerie1 if Serie1.Document is Nothing then MsgBox "NULL document" else MsgBox Serie1.Document.WindowCaption end if end sub
|function CopyToClipboard: VOID|
For DMNotes, this method copies selected text on the clipboard as in any text editor.
For DMPlot, CopyToClipboard has a parameters. Mode parameter determine what data will be copied; possible values listed in the PlotCopyModes enumeration. UseTabs parameter defines what character will be used as separator between values: some programs can correctly paste values only if they are separated by tabstop character. Keep in mind that CopyToClipboard acts only on the data in the current plot serie, and only points whose coordinates are within the selection area are copied. If plot selection is not visible, all points or data elements are copied.
For both DMSerie and DMLabel, properties of the object are copied in the special binary format.
For DMWorksheet, it copies selected worksheet cells to the clipboard as a simple text block. UseTabs parameter also defines what character will be used as separator between values. It also puts selection data range as a serie object.
You can use system Clipboard Viewer utility to investigate what data formats are used at every case.
|function PasteFromClipboard: VOID|
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.
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.
|function CanPaste: Boolean|
CanPaste method returns True if clipboard has valid data for PasteFromClipboard method. Use it to monitor controls associated with "Paste" command.
|function Select: VOID|
For DMNotes object, this method should be used to select text in the editor. SelStart and SelEnd parameters are first and last character positions.
For DMPlot object, Select() changes numeric (double precision) coordinates of the plot selection area. This area may be visualized using SelectionVisible property and affects on some plot editing commands.
For DMWorksheet, this method defines integer coordinates of the worksheet selection. Left and Right ranges are (1..26), Top and Bottom are (0..Container.ItemCount-1).
For DMSerie, Select() has almost the same meaning as for DMWorksheet. Columns are ranged from 1 to 26, lines - from 0 to Container.ItemCount-1. However, XCol and YCol must represent valid data, that is, all items in the selected data range must have appropriate number of columns.
For DMLabel, this method allows you programmatically select label object. Notice that Select() has no effect until IDMPlot2.MouseMode<>pmmLabelEdit.
|function Move(XMin, YMin, XMax, YMax): VOID|