ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Various properties
  • Report (Report editor): Visible or invisible control/block
  • State of a group of controls
  • State of a column in a Table control
  • Limitations
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
The State property is used to get and change the state:
  • of a control in a window, page or report.
  • of a block in a report,
  • of a window.
WEBDEV - Server codeWEBDEV - Browser code In a page, the State property is used to get and change the state:
  • of a control or group of controls,
  • of a "container" control (Tab, Internal Page, Layout, etc.)
  • of a group of controls.
WEBDEV - Server code 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
WEBDEV - Server codePHPAjax
// The EDT_Edit1 control becomes active
EDT_Edit1.State = Active
// Modify the content of the Combo Box if it is active
IF COMBO_Combo1.State = Active THEN
COMBO_Combo1 = "<Enter HERE>"
SetFocusAndReturnToUserInput(COMBO_Combo1)
END
Syntax
WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Finding out the state of a control in a page Hide the details

<Current state> = <Control name>.State
<Current state>: Integer constant
Current state of the object.
Active or VisibleThe control is active and editable.
GrayedControl grayed out.
InactiveThe edit control is visible and read-only (applies to the edit controls only).
InvisibleInvisible (it is recommended to use the Visible property).
WEBDEV - Browser code This constant is not available. Use the Visible property.
Remark: in List Box and Combo Box controls, 'Disabled' is equivalent to 'Grayed'.
<Control name>: Character string
Name of control or group of controls.
WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Changing the state of a control in a page Hide the details

<Control name>.State = <New state>
<Control name>: Character string
Name of control or group of controls.
<New state>: Integer constant
New state of the object.
Active or VisibleThe control is active and editable.
GrayedThe control is grayed out
InactiveThe edit control is visible and read-only (applies to the edit controls only).
InvisibleInvisible control (it is recommended to use the Visible property).
WEBDEV - Browser code This constant is not available. Use the Visible property.
Remarks:
  • In List Box and Combo Box controls, 'Disabled' is equivalent to 'Grayed'.
  • The change of state may result in slightly different effects depending on the browser used. For example, the grayed state will be more noticeable in Internet Explorer and Chrome than in Firefox.
WEBDEV - Server code

Getting 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.
ActiveThe control or block is visible.
InvisibleInvisible control or block (it is recommended to use the Visible property).
<Element name>: Character string
Name of report control or block.
WEBDEV - Server code

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 state of the object.
ActiveThe control or block is visible.
InvisibleInvisible control or block (it is recommended to use the Visible property).
Remarks

Report (Report editor): Visible or invisible control/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

  • Finding out the state of a group of controls: the state corresponds to the state of the first control in the group.
  • Changing 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 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).
Caution: the State property only restricts the state of the column defined in the description window. For example, if the column is read-only, no column cell can become editable.

Limitations

WEBDEV - Server code The State property has no effect on reports created with the report editor.
WEBDEV - Browser code The State property has no effect on the following elements:
  • Table,
  • TreeView Table,
  • Looper
  • Linear Looper
  • Table column.
Minimum version required
  • Version 9
This page is also available for…
Comments
PROCEDURE evento_state_fields(myNameWindow,myNameControl)
// ReadOnlyNoSelection // OutsideScreen // Grayed // DisplayOnly // Active

Indirection is string = myNameWindow +"."+ myNameControl

SWITCH {Indirection}..State
CASE Active
RESULT "1-Active"
CASE ReadOnlyNoSelection
RESULT "2-ReadOnly"
CASE Grayed
RESULT "3-Grayed"
CASE DisplayOnly
RESULT "4-DisplayOnly"
OTHER CASE
RESULT "5-Other"
END
Boller
02 Sep. 2023

Last update: 03/16/2023

Send a report | Local help