State (Property)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

Visible or invisible control/block
Status of a group of controls
Status 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 status:

of a control,
of a report block.

Note: 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 status of an element in a report Hide the details

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

<Current status>: Integer constant

Current status of object.
Active The control or block is visible.
Invisible The control or block is invisible (we recommend that you use ..Visible).

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

Name of report control or block.

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

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

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

Name of report control or block.

<New status>: Integer constant

New status of object.
Active The control or block is visible.
Invisible The control or block is invisible (we recommend that you use ..Visible).

Remarks

Visible or invisible control/block

In a report, the only possible status for a control or a block is visible or invisible. To manage the control visibility, we recommend that you use ..Visible. This property optimizes the management of control visibility.

Status of a group of controls

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

Status of a column in a Table control

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

Caution: ..State can only be used to restrict the status of 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.