State (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Visible or invisible control/block
State of a group of controls
State of a column in a Table control
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

State (Property)

In french: Etat

..State can be used:

in a report.
in a window.
in a page.

In a report, ..State is used to find out and modify the display state:

of a control,
of a report block.

Remark: In a report, ..State can only be used to manage the visibility of a control or block (a control or a block cannot be grayed). In this case, this property is available for backward compatibility with WINDEV 5.5 and WEBDEV 1.5. To manage the visibility of a control or block in a report, we recommend that you use ..Visible.

Example

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

Syntax

Finding out the state of an element in a report Hide the details

<Current state> = <Element name>..State

<Current state>: Integer constant

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

<Element name>: Character string (with or without quotes)

Name of report control or block.

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

<Element name>..State = <New state>

<Element name>: Character string (with or without quotes)

Name of report control or block.

<New state>: Integer constant

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

Remarks

Visible or invisible control/block

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

State of a group of controls

Finding out the state of a group of controls: the state corresponds to the state of the first control in the group.
Modifying the state of a group of controls: all the controls of the group are modified and correspond to the new state.

State of a column in a Table control

If ..State is applied to a column, the state of the entire column is changed (and not just the state of a column cell).

Caution: ..State can only be used to restrict the state of the column defined in the description window. For example, if the column is read-only, no column cell can become editable.

Limits

..State has no effect on the reports.