PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Visible or invisible control/block
  • State of a group of controls
  • State of a column in a Table control
  • Limits
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
..State can be used:
  • in a report.
  • in a window.
  • in a page.
WEBDEV - Server code 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.
WEBDEV - Server codeWEBDEV - Browser code In a page, ..State is used to find out and modify the display state:
  • of a control.
  • of a group of controls.
Versions 22 and later
WEBDEV - Browser code This property is now available in browser code.
New in version 22
WEBDEV - Browser code This property is now available in browser code.
WEBDEV - Browser code This property is now available in browser code.
Example
WEBDEV - Server codePHPAjax
// 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>"
ReturnToCapture(COMBO_Combo1)
END
Syntax
WEBDEV - Server code

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.
ActiveThe control or block is visible.
InvisibleThe 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.
WEBDEV - Server code

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.
ActiveThe control or block is visible.
InvisibleThe control or block is invisible (it is recommended to use ..Visible).
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.
InactiveThe edit control is visible and read-only (applies to the edit controls only).
InvisibleInvisible (we recommend that you use ..Visible).
WEBDEV - Browser code This constant is not available. Use ..Visible.
Remark: in List Box and Combo Box controls, 'Inactive' is equivalent to 'Grayed'.
<Control name>: Character string (without quotes)
Name of control or group of controls.
WEBDEV - Server codeWEBDEV - Browser codePHPAjax

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

<Control name>..State = <New state>
<Control name>: Character string (without quotes)
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
InactiveThe edit control is visible and read-only (applies to the edit controls only).
InvisibleThe control is invisible (it is recommended to use ..Visible).
WEBDEV - Browser code This constant is not available. Use ..Visible.
Remarks:
  • In List Box and Combo Box controls, 'Inactive' 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.
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.
WEBDEV - Server codePHPAjax

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

WEBDEV - Server code ..State has no effect on the reports.
WEBDEV - Browser code ..State 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
Click [Add] to post a comment