IDMEditControl Interface

Version: 2.0
Dispatch interface for DMxxxEdit Controls

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

This interface includes methods and properties of several types of numeric edit ActiveX controls. Such controls simplify editing integer and float numbers since they have special buttons for changing value without typing.

Keep in mind that unlike Text property, which is of string type, Value property has numeric type.

Members:
Kind Name ID Description
Color -501 Change control color
IsEditorEnabled 101 Change EditorEnabled VCL property
Enabled -514 Enable or disable control
Font -512 Change control font
Increment 102 Change Value increment
Max 103 Change maximal Value
Min 104 Change minimal Value
IsParentColor 105 Change VCL ParentColor property
IsReadOnly 106 Change ReadOnly VCL property
Value 107 Change control numeric value
IsVisible 108 Change control visibility
Text -517 Change control value as text
Format 109 Change number format

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 IsEditorEnabled: Boolean

Applies to:
DMFloatEdit, DMSpinEdit

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 Increment: Variant

Applies to:
DMFloatEdit, DMSpinEdit

Syntax:
property Max: Variant

Applies to:
DMAxis, DMFloatEdit, DMSerie, DMSpinEdit

For DMAxis, Max defines maximal value of the axis range. Note: if you want to fix axis range you have to clear AutoScale flag. Also keep in mind that in DM2003 Min may be greater than Max.

For DMSerie, this property allows you to change maximal limit of the parameter ("cx") for parameterized (or functional) series.

For DMSpinEdit and DMFloatEdit ActiveX controls, it defines maximal possible value of the Value property.

Syntax:
property Min: Variant

Applies to:
DMAxis, DMFloatEdit, DMSerie, DMSpinEdit

For DMAxis, Min define minimal value of the axis range. Note: if you want to fix axis range you have to clear AutoScale flag. Also keep in mind that in DM2003 Min may be greater than Max.

For DMSerie, this property allows you to change minimal limit of the parameter ("cx") for parameterized (or functional) series.

For DMSpinEdit and DMFloatEdit ActiveX controls, it defines minimal possible value of the Value property.

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 IsReadOnly: Boolean

Applies to:
DMFloatEdit, DMSpinEdit

Syntax:
property Value: Variant

Applies to:
DMFloatEdit, DMIniFile, DMRegistry, DMSpinEdit

For DMINIFile, Value should be used to change either contents of the selected section or the "value" part of the selected record (after "=" character). Section value treated as a bulk text, without Name=Value separation. For DMRegistry, Value() property should be used to change registry values.

If appropriate object was opened in the read-only mode, setting Value will have no effect. Parameter Name is either integer index (ranged from 0 to Items.ItemCount-1) or the string-type name of the value.

For DMSpinEdit and DMFloatEdit, Value property just wraps around appropriate Delphi VCL property. Unlike Text, it has numeric type.

Example:

dim INI, S, Ss
set INI=CreateObject("DMForms.DMINIFile")
S=""
if INI.Open("C:\MyFile.ini*MySection", true) then
  for each Ss in INI.Items
    S=S & Ss
  next
  MsgBox S  
end if

See also:
DMINIFile, DMRegistry test pages.

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 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 Format: BSTR

Applies to:
DMAxis, DMFloatEdit, DMSpinEdit, DMWorksheet

This property allows you to change numeric format. Possible values are: XX.Yt, where XX - total number of digits, Y - number of digits after decimal point, t - one of the following characters:

Another type of strings used for Date and Time format feature. If format specifier value enclosed in the curly brackets, it is treated as date/time.