State (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage properties / Various properties

Status (Status editor): Visible or invisible field/block
State of a group of controls
State of a column in a Table control
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

State (Property)

In french: Etat

The State property gets and sets the state:

of a control in a window, page or report.
of a block in a report,
of a window.

In a report, the State property is used to get and change the visibility of a control or block. This property is kept for compatibility with WINDEV 5.5 and WEBDEV 1.5. To show or hide a control or a block in a report, use the Visible property.

Example

// The STC_Static1 control becomes active
STC_Static1.State = Active

Syntax

Getting the state of an element in a report Hide the details

<Current state> = <Element name>.State

<Current state>: Integer constant

Current status of object.
Active The control or block is visible.
Invisible Invisible control or block (it is recommended to use the Visible property).

<Element name>: Character string

Name of report control or block.

Changing the state of an element in a report Hide the details

<Element name>.State = <New state>

<Element name>: Character string

Name of report control or block.

<New state>: Integer constant

New object state.
Active The control or block is visible.
Invisible Invisible control or block (it is recommended to use the Visible property).

Remarks

Status (Status editor): Visible or invisible field/block

In a report, the only possible state for a control or a block is visible or invisible. To set the visibility of a control, it is recommended to use the Visible property. This property optimizes the management of control visibility.

State of a group of controls

Find out the status of a group of fields: the status returned corresponds to the status of the first field in the group.
Modify the status of a group of fields: all the fields in the group are modified to match the new status.

State of a column in a Table control

If the State property is applied to a column of a Table control, the state of the entire column is changed (and not only the state of the cell).

Please note: the State property can only be used to restrict the column status defined in the description window.. For example, if the column is read-only, no column cell can become editable.

Limitations

The State property has no effect on reports created with the report editor.