​.Value Dotfield

Default property for all InTouch windows control wizards. Changes made to this property are synchronized in the InTouch tagname and the windows control wizards.

Category

windows control

Usage

The M, I and D are for the Memory, Integer and Discrete versions of the GetProperty and SetProperty functions.

[ErrorNumber=]GetPropertyM("ControlName[.Value]", Tagname);

[ErrorNumber=]SetPropertyM("ControlName[.Value]", Value);

[ErrorNumber=]GetPropertyI("ControlName[.Value]", Tagname);

[ErrorNumber=]SetPropertyI("ControlName[.Value]", Value);

[ErrorNumber=]GetPropertyD("ControlName[.Value]", Tagname);

[ErrorNumber=]SetPropertyD("ControlName[.Value]", Value);

Parameters

ControlName

Name of the windows control, e.g., ChkBox_4.

Tagname

The tagname to which the value of the property is written.

[.Value]

This property is optional. If not specified, the function always assumes the .Value property is being used.

Value

The actual value to be written or a valid InTouch tagname (of the same type as the property to be written to) that holds the property value to be written when the function is processed.

Remarks

The initial value of tagnames assigned to either a list box or combo box cannot be used to initialize the value of the list box or combo box.

This dotfield is read/write during development and run time. If the .Value dotfield is accessed by associating a tagname to either a list box or a combo box, it is read-only. If the .Value dotfield is assigned to a checkbox, radio button, or text box, it is read/write. The value you specify at development serves as the default for run time.

Data Type

Message (read/write) for text boxes, list boxes and combo boxes.

Integer (read/write) for radio buttons.

Discrete (read/write) for checkboxes.

Applies To

Text boxes, list boxes, combo boxes, checkboxes and radio buttons.

Example(s)

The following statement sets the .Value dotfield of the radio button object "RadioButton_1" to a value of 4:

SetPropertyI( "RadioButton_1.Value", 4 );

See Also

GetPropertyM(), SetPropertyM(), GetPropertyI(), SetPropertyI(), GetPropertyD(), SetPropertyD()