IDMListControl Interface

Version: 2.0
Dispatch interface for DMxxxBox controls

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

This interface includes methods and properties of several types of the ComboBox and ListBox ActiveX controls. Most important are Text property that represents text in the control, and Items property - a reference to the collection of additional text lines in the control's list. ItemIndex property allows you to select an item from this list.

Members:
Kind Name ID Description
IsAutoComplete 101 Change VCL AutoComplete property
BevelInner 102 Change VCL BevelInner property
BevelKind 103 Change VCL BevelKind property
BevelOuter 104 Change VCL BevelOuter property
ComboBoxStyle 105 Change combobox style
Color -501 Change control color
DropDownCount 106 Change VCL DropDownCount property
Enabled -514 Enable or disable control
Font -512 Change control font
ItemIndex 107 Change index of the selected item
IsParentColor 108 Change VCL ParentColor property
IsSorted 109 Make Items sorted
Text -517 Change the selected item text
IsVisible 110 Change control visibility
Items 111 Return Items collection object
IsDroppedDown 112 Change VCL DroppedDown property
TopIndex 113 Change VCL TopIndex property

Syntax:
property IsAutoComplete: Boolean

Applies to:
DMComboBox, DMExpressionComboBox, DMListBox

Syntax:
property BevelInner: User_Defined

Applies to:
DMComboBox, DMExpressionComboBox, DMListBox

This property affects control's border. Possible values are listed in the TxBevelCut enumeration.

Syntax:
property BevelKind: User_Defined

Applies to:
DMComboBox, DMExpressionComboBox, DMListBox

This property affects control's border. Possible values are listed in the TxBevelKind enumeration.

Syntax:
property BevelOuter: User_Defined

Applies to:
DMComboBox, DMExpressionComboBox, DMListBox

This property affects control's border. Possible values are listed in the TxBevelCut enumeration.

Syntax:
property ComboBoxStyle: User_Defined

Applies to:
DMComboBox, DMExpressionComboBox, DMListBox

This property affects style of the combobox controls. Possible values are listed in the TxComboBoxStyle enumeration.

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:
property Font: PTR

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

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.

Example:

 
Server.ActiveDocument.Worksheet.Font.Name
Server.ActiveDocument.Worksheet.Font.Size
Server.ActiveDocument.Worksheet.Font.Bold
Server.ActiveDocument.Worksheet.Font.Italic
Server.ActiveDocument.Worksheet.Font.Underline
Server.ActiveDocument.Worksheet.Font.Strikethrough
Server.ActiveDocument.Worksheet.Font.Weight
Server.ActiveDocument.Worksheet.Font.Charset
Server.ActiveDocument.Worksheet.Font.Color 'absent!

Syntax:
property ItemIndex: Long

Applies to:
DMComboBox, DMExpressionComboBox, DMLabel, DMListBox, DMSerie

For a list controls in DMForms, this property may be used to change selected item in the list. For DM2003 collection items (series and labels) it represents the index of the item in the appropriate collection. This feature allows much more convienient manipulations with collection items.

Examples:

Doc.Plot.Series(0).ItemIndex=2
  is equal to:
Doc.Plot.Series(0).Move(2)
  and
Doc.Plot.Labels(1).SendToBack   
  is equal to:
Doc.Plot.Labels(1).ItemIndex=0

Syntax:
property IsParentColor: Boolean

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

This property determines whether given control inherits value of the color property from the ambient environment.

Syntax:
property IsSorted: Boolean

Applies to:
DMComboBox, DMExpressionComboBox, DMListBox

Syntax:
property Text: BSTR

Applies to:
B740X, DMComboBox, DMExpressionComboBox, DMFloatEdit, DMLabel, DMListBox, DMListItems, DMNotes, DMSerie, DMSpinEdit, DMStrings, E712X, HP4191X

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.

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:
r/o property Items: PTR

Applies to:
DMComboBox, DMContainer, DMDigitizerContainer, DMExpressionComboBox, DMIniFile, DMLabels, DMListBox, DMListItems, DMRegistry, DMStrings

For DMINIFile, Items return either collection of INI file sections (if no section was defined in the Open method) OR the collection of names of records in the selected section. Use Value() property to access section contents (or Value) of the selected record. For DMRegistry, Items return the collection of names of the records (values) under the selected registry key.

Items collection filled in the Open method and is read-only. Don't try to change it anyway. Use Value() property to change values.

For DMComboBox, DMExpressionComboBox and DMListBox, Items represent a read/write collection of strings in the appropriate control.

For DMContainer and DMDigitizerContainer, Items is a parameterized property - an array of data items ("for each" cycle still can be performed on the object itself). Each data item is a variant array of double-precision numbers. Notice that for DMDigitizerContainer, you can only read Items. For DMContainer, you may assign either variant array OR just a properly formatted string to the Items() property.

For DMListItems and DMStrings, Items is a parameterized property that returns (or changes) a string selected by Index parameter (0..ItemCount-1).

For DMLabels collection, this is a default, parameterized (0..ItemCount-1) property that returns references to the DMLabel objects.

Syntax:
property IsDroppedDown: Boolean

Applies to:
DMComboBox, DMExpressionComboBox, DMListBox

Syntax:
property TopIndex: Long

Applies to:
DMComboBox, DMExpressionComboBox, DMListBox