InitialState (Property)

The InitialState property is used to get the initial state of a control. The initial status corresponds to the status defined during the control description ("UI" tab).


Initial status of edit control ("UI" tab)	Initial status of control (button for example)
Initial status of Table control ("UI" tab)	Initial status of table column ("UI" tab)

To know if a control is visible, use the Visible property.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 18 and later

This property is now available in Windows Store apps mode.

New in version 18

This property is now available in Windows Store apps mode.

Versions 20 and later

This property is only available for Table controls in iPhone/iPad applications.

This property is now available for Table controls and table columns in Android applications.

New in version 20

This property is only available for Table controls in iPhone/iPad applications.

This property is now available for Table controls and table columns in Android applications.

This property is only available for Table controls in iPhone/iPad applications.

This property is now available for Table controls and table columns in Android applications.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

Versions 23 and later

This property is now available for PHP sites.

This property is now available in browser code.

This property is now available for WEBDEV sites in Linux and in Windows.

New in version 23

This property is now available for PHP sites.

This property is now available in browser code.

This property is now available for WEBDEV sites in Linux and in Windows.

This property is now available for PHP sites.

This property is now available in browser code.

This property is now available for WEBDEV sites in Linux and in Windows.

Example

IF BTN_Close.InitialState = Grayed THEN
BTN_Close.State = Active
END

Syntax

<Initial status> = <Control>.InitialState

<Initial status>: Integer constant

Initial status of the control, defined in the editor.
Active The control is active, visible and in edit
DisplayOnly or Inactive The control is read-only, no input or action is allowed
For the Table controls, the user will be able to select a table row. It can also be selected through programming with TableSelectPlus.
Grayed The control is grayed
ReadOnlyNoSelection For the Table controls only: The control is read-only, no input is allowed.
In this case, the user will not be able to select a table row with the mouse or with the arrows. A row can only be selected through programming with TableSelectPlus. This row will be selected via the selection bar.
This constant is not available.

<Control>: Name of control or group of controls

Name of control or group of controls.

Remarks

State of a group of controls

If the InitialState property is used on a group of controls, the state returned is the initial state of the first control in the group.

Limits

The InitialState property cannot be used on a menu or menu option.
The InitialState property has no effect on HTML controls.
The InitialState property is only available on Table controls.