Type: Integer (scroll bars), Boolean (check box, button, JADE mask, and option button)
Availability: Read or write at any time
The value property determines the state of a CheckBox control as checked or unchecked. The default value is zero (0), or false.
For Button and JadeMask controls, the value property specifies whether the state of the button or mask control is up (false) or down (true). Setting the value property is ignored for a normal push button or mask control with a style property of Style_Normal (0). For a two-state or an automatic two-state button or mask control, setting this property pushes or raises the button or mask control. For an automatic two-state button or mask control, setting the value property to true also causes other automatic two-state buttons or mask controls with the same parent to come up. For automatic two-state buttons or mask controls, setting the value property to false has no impact on other buttons or mask controls in the same group.
For OptionButton controls, setting the value property to true causes other option buttons in the same group to be set to false. Setting the value property to false has no impact on other option buttons in the same group.
For horizontal and vertical ScrollBar controls, the value property determines the current position of the scroll bar. The value that is returned is always between the values for the max and min properties.
The settings for the value property are listed in the following table.
| Control | Description |
|---|---|
| CheckBox | false is unchecked (default), true is checked |
| Button and JadeMask | false indicates the button is up, true indicates the button is down |
| ScrollBar | Set values between the min and max properties, to position the scroll box |
| OptionButton | true indicates the button is selected, false (the default) indicates the button is not selected |
The following example shows the use of the value property.
tranState_click(checkbox: CheckBox input) updating;
begin
if tranState.value then
if not process.isInTransactionState then
beginTransaction;
sl1.caption := $S_In_Transaction_State;
endif;
else
if process.isInTransactionState then
commitTransaction;
sl1.caption := $S_Not_In_Transaction_State;
endif;
endif;
end;