PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Visible or invisible control/block
  • Status of a group of controls
  • Status 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 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.
WEBDEV - Server codeWEBDEV - Browser code In a page, ..State is used to find out and modify the display status:
  • of a control.
  • of a group of controls.
PHP The status of a control can be modified for the "Automatic" or "Dynamic" controls only ("Details" tab of control description). To manage the visibility of a control, use ..Visible.
PHP The status of a control can be modified for the "Automatic" or "Dynamic" controls only ("GUI" tab of control description). To manage the visibility of a control, use ..Visible.
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 status of an element in a report Hide the details

<Current status> = <Element name>..State
<Current status>: Integer constant
Current status of object.
ActiveThe control or block is visible.
InvisibleThe 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.
WEBDEV - Server code

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.
ActiveThe control or block is visible.
InvisibleThe control or block is invisible (we recommend that you use ..Visible).
WEBDEV - Server codePHPAjax

Finding out the status of a page control Hide the details

<Current status> = <Control name>..State
<Current status>: Integer constant
Current status of 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).
Note: on the List Box and Combo Box controls, the 'Inactive' status is equivalent to the 'Grayed' status.
<Control name>: Character string (without quotes)
Name of control or group of controls.
WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Finding out the status of a page control Hide the details

<Current status> = <Control name>..State
<Current status>: Integer constant
Current status of 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.
Note: on the List Box and Combo Box controls, the 'Inactive' status is equivalent to the 'Grayed' status.
<Control name>: Character string (without quotes)
Name of control or group of controls.
WEBDEV - Server codePHPAjax

Modifying the status of a page control Hide the details

<Control name>..State = <New status>
<Control name>: Character string (without quotes)
Name of control or group of controls.
<New status>: Integer constant
New status of 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 (we recommend that you use ..Visible).
Notes:
  • On the List Box and Combo Box controls, the 'Inactive' status is equivalent to the 'Grayed' status.
  • The change of status may results in slightly different effects according to the browser used. For example, the grayed status will be more visible in Internet Explorer and Chrome than in Firefox.
WEBDEV - Server codeWEBDEV - Browser codePHPAjax

Modifying the status of a page control Hide the details

<Control name>..State = <New status>
<Control name>: Character string (without quotes)
Name of control or group of controls.
<New status>: Integer constant
New status of 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 (we recommend that you use ..Visible).
WEBDEV - Browser code This constant is not available. Use ..Visible.
Notes:
  • On the List Box and Combo Box controls, the 'Inactive' status is equivalent to the 'Grayed' status.
  • The change of status may results in slightly different effects according to the browser used. For example, the grayed status will be more visible in Internet Explorer and Chrome than in Firefox.
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.
WEBDEV - Server codePHPAjax

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

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