Value Property

object.Value = [string]

Client support

   Newlook Smartclient

   Newlook Server

Use

This property can be used to set a CheckBox's initial checked state and to set or return its state at runtime.

If the Choices property is blank, then the Value property will return 0 when the checkbox is unchecked, 1 when the checkbox is checked, or 2 if the check box is tri-state and the state is unknown.

If the Choices property contains a pair of semi-colon delimited choices, then Value will return the second choice in the pair when unchecked, the first choice in the pair when checked, or an empty string if the checkbox is tri-state and the state is unknown.

If the Choices property contains a single value instead of a pair of options, this value represents the selected state of the checkbox, the unchecked and grayed state will both return an empty string.

BE AWARE THAT:

It's important to note that this property always returns a string when used with the check box control and hence any comparison expressions using this property must use strings.

tip:

For Check box and Option buttons this property may be entered as an expression in Designer, by preceding the expression with an equals (=) sign. The expression will be evaluated when the form is initialized, and the property will be set to the result of the expression.

object.Value = [string]

Client support

   Newlook Smartclient

   Newlook Server

Use

This property can be used to set the initial state and get or set the runtime state of an individual option button. A value of "1" indicates a selected state; "0" indicates an un-selected state. Use this property in conjunction with the BuddyValue property to determine the value that will be sent back to the host if the option button is selected (relevant for host-generated option buttons only).

BE AWARE THAT:

It's important to note that this property always returns a string when used with the option button control and hence any comparison expressions using this property must use strings ("1" for selected and "0" for unselected).

tip:

For Check box and Option buttons this property may be entered as an expression in Designer, by preceding the expression with an equals (=) sign. The expression will be evaluated when the form is initialized, and the property will be set to the result of the expression.

Client support

   Newlook Smartclient

   Newlook Server

Use

Returns the value of the field for the current record. This property varies according to the Type property specified for the Field object

Client support

   Newlook Smartclient

   Newlook Server

Use

This property gets or sets the current value of the UpDown control. If this value is not within the control's valid range at runtime (specified by its Min and Max properties) then this property will default to the closest value within the Min-Max range.

If the UpDown control is bound to a buddy control, then the initial Value property of the UpDown control may not be the same as the initial contents of its buddy control (which is determined by the buddy control's Text property). If the buddy control's entry field contains a numeric value, then clicking the UpDown control will increment/decrement the buddy control's value by 1, providing this value is within the accepted Min-Max range. If the bound buddy control is blank or contains a non-numeric value, then the first time a user interacts with the UpDown control, the buddy entry field will be set to the same number as the UpDown's Value property.

It is important to note that the contents of an entry field bound to an UpDown control are not limited by the Min, Max or Value properties of the UpDown control. These properties simply limit the values sent through to the bound control when the user clicks the UpDown control.

Client support

   Newlook Smartclient

   Newlook Server

Use

Sets or returns the current progress value of the ProgressBar control or position of the TrackBar thumb. If unspecified, this property will default to the value of the Min property.