InitialState (Property)

..InitialState is used to find out the initial status 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 find out whether a control is visible or not, use ..Visible.

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 now only available for Table fields 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 now only available for Table fields in iPhone/iPad applications.

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

This Property is now only available for Table fields 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
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 by programming with TableSelectPlus. This row will be selected via the selection bar.
This constant is not available.
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 by programming with TableSelectPlus.

<Control>: Name of control or group of controls

Name of control or group of controls.

Remarks

State of a group of controls

If ..InitialState is used on a group of controls, the status returned corresponds to the initial status of the first control found in the group.

Limits

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