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
  • Tabs and controls of a tab pane
  • Sidebar and pane controls
  • Radio Button/Check Box controls and their options
  • Active control made invisible or not
  • Menu options
  • 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.
WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadWindows MobileUniversal Windows 10 App 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.
WINDEVWINDEV Mobile In a window, ..State is used to find out and modify the display status:
  • of a window,
  • of a control or group of controls,
  • of a table cell or table row,
  • of a menu option.
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 16 and later
Universal Windows 10 App This property is now available for the Windows Phone applications.
New in version 16
Universal Windows 10 App This property is now available for the Windows Phone applications.
Universal Windows 10 App This property is now available for the Windows Phone applications.
Versions 15 and later
Android This property is now available for the Android applications.
New in version 15
Android This property is now available for the Android applications.
Android This property is now available for the Android applications.
Versions 17 and later
iPhone/iPad This property is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This property is now available for the iPhone/iPad applications.
iPhone/iPad This property is now available for the iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This property is now available in Windows Store Apps mode.
iPhone/iPad This property is now available for the report controls and blocks in the iPhone/iPad applications.
New in version 18
Universal Windows 10 App This property is now available in Windows Store Apps mode.
iPhone/iPad This property is now available for the report controls and blocks in the iPhone/iPad applications.
Universal Windows 10 App This property is now available in Windows Store Apps mode.
iPhone/iPad This property is now available for the report controls and blocks in the iPhone/iPad applications.
Versions 20 and later
AndroidiPhone/iPad This property is now available for the Table controls and for the table columns in the Android applications and in the iPhone/iPad applications.
New in version 20
AndroidiPhone/iPad This property is now available for the Table controls and for the table columns in the Android applications and in the iPhone/iPad applications.
AndroidiPhone/iPad This property is now available for the Table controls and for the table columns in the Android applications and in the iPhone/iPad applications.
Versions 21 and later
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Apple Watch This property is now available in Apple Watch mode.
New in version 21
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Apple Watch This property is now available in Apple Watch mode.
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Apple Watch This property is now available in Apple Watch mode.
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
WINDEVWEBDEV - Server codeReports and QueriesAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaPHPAjaxUser code (UMC)
// The STC_Static1 control becomes active
STC_Static1..State = Active
WINDEVWEBDEV - Server codeAndroidWindows MobileUniversal Windows 10 AppJavaPHPAjaxUser code (UMC)
// 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
WINDEV
// Grays the 4th row in the table
TABLE_Customer[4]..State = Grayed
// Grays the 1st cell of column 2
COL_COL2[1]..State = Grayed
// Makes the 5th row neither clickable nor editable
TABLE_Customer[5]..State = ReadOnlyNoSelection
// Makes the 2nd cell of column 3 neither clickable nor editable
COL_COL3[2]..State = ReadOnlyNoSelection
// Makes the cell active
COL_COL3[2]..State = Active
Syntax
WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadWindows MobileUniversal Windows 10 App

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.
WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadWindows MobileUniversal Windows 10 App

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).
WINDEVAndroidiPhone/iPadApple WatchWindows MobileUniversal Windows 10 AppJavaUser code (UMC)

Finding out the status of an element in a window or the status of a window Hide the details

<Current status> = <Element name>..State
<Current status>: Integer constant
Current status of object.
Window controls
ActiveThe control is active and editable.
ReadOnlyNoSelectionFor the Table controls only: The control is read-only, no input is allowed.

In this case, the user will not be able to select a table row with the mouse or with the arrows. A row can only be selected by programming with TableSelectPlus. This row will be selected via the selection bar.
DisplayOnly or InactiveThe control is read-only, no input or action is allowed.
For the Table, TreeView Table and Looper controls, the user will be able to select a table row. It can also be selected by programming (with TableSelectPlus for the tables).
GrayedControl grayed.
Table row or Table cell, TreeView table, List Box, ListView, Combo Box, Looper
ActiveThe control is active and editable (if the table is in edit).
ReadOnlyNoSelectionThe control is read-only, no input or action is allowed. The user will not be able to select a table row with the mouse or with the arrow keys. A row can only be selected by programming with TableSelectPlus.

This row will be selected via the selection bar.
GrayedThe control is grayed
Java Feature not supported.
Windows
ActiveWindow that can be handled by the user.
DisplayOnlyThe window controls are no longer accessible in modification. However, the user will be able to modify the row selected in the Table, TreeView Table or Looper controls. The window cannot be moved.
GrayedGrays all window controls.
OutsideScreenThe window is active but its coordinates are negative
<Element name>: Character string (with or without quotes)
Name of control, table row, cell, group of controls or window.
WINDEVAndroidiPhone/iPadApple WatchWindows MobileUniversal Windows 10 AppJavaUser code (UMC)

Modifying the status of an element in a window or the status of a window Hide the details

<Element name>..State = <New status>
<Element name>: Character string (with or without quotes)
Name of control, table row, cell, group of controls or window.
<New status>: Integer constant
New status of element.
Window controls
ActiveThe control is active and editable.
ReadOnlyNoSelectionFor the Table controls only: The control is read-only, no input is allowed.
In this case, the user will not be able to select a table row with the mouse or with the arrows. A row can only be selected by programming with TableSelectPlus. This row will be selected via the selection bar.
DisplayOnly or InactiveThe control is read-only, no input or action is allowed.
For the Table, TreeView Table and Looper controls, the user will be able to select a row. It can also be selected by programming (with TableSelectPlus for the tables).
GrayedThe control is grayed
Table row or Table cell, TreeView table, List Box, ListView, Combo Box, Looper
ActiveThe control is active and editable (if the table is in edit).
ReadOnlyNoSelectionThe control is read-only, no input or action is allowed. The user will not be able to select a table row with the mouse or with the arrow keys. A row can only be selected by programming with TableSelectPlus.
This row will be selected via the selection bar.
GrayedControl grayed.
Windows
ActiveWindow that can be handled by the user.
DisplayOnlyThe window controls are no longer accessible in modification. However, the user will be able to modify the row selected in the Table, TreeView Table or Looper controls. The window cannot be moved.
GrayedGrays all window controls.
OutsideScreenThe window is active but its coordinates are negative.
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.
WINDEVWEBDEV - Server codeReports and QueriesAndroidiPhone/iPadWindows MobileJavaPHPAjaxUser code (UMC)

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.
Versions 20 and later
AndroidiPhone/iPad The Table controls are now available in the iOS and Android applications.
New in version 20
AndroidiPhone/iPad The Table controls are now available in the iOS and Android applications.
AndroidiPhone/iPad The Table controls are now available in the iOS and Android applications.
WINDEVAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaUser code (UMC)

Tabs and controls of a tab pane

The status of a control found in a tab pane depends on the status of tab pane:
  • If the pane is not selected, the control is invisible.
  • If the pane is selected and invisible, the control is invisible.
  • If the pane is selected and grayed, the control is grayed.
  • If the pane is selected and inactive, the control is inactive.
  • If the pane is selected and active, the control can be active, inactive, grayed or invisible.
WINDEVWindows MobileUser code (UMC)

Sidebar and pane controls

The status of a control found in a sidebar pane depends on the status of the pane:
  • If the pane is not selected, the control is invisible.
  • If the pane is selected and invisible, the control is invisible.
  • If the pane is selected and grayed, the control is grayed.
  • If the pane is selected and inactive, the control is inactive.
  • If the pane is selected and active, the control can be active, inactive, grayed or invisible.
WINDEVAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaUser code (UMC)

Radio Button/Check Box controls and their options

You can modify the status of the control or the status of an option found in the Radio Button or Check Box. An option can be grayed or active.
  • To modify the status of a Radio Button control:
    RADIO_Radio1..State = Grayed
  • To modify the status of an option found in a Radio Button control:
    RADIO_Radio1[2]..State = Grayed
Caution: The status of an option depends on the status of the Radio Button control. Therefore, if the following operations are performed:
  1. An option is grayed.
  2. The Radio Button/Check Box control is grayed.
  3. The Radio Button/Check Box control is re-enabled. The option is still grayed.
WINDEVAndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaUser code (UMC)

Active control made invisible or not

A control (active, grayed, read-only) can be made invisible by ..Visible.
When the control is invisible, it loses all the characteristics of its previous status: the control is invisible and it cannot be used. The only way to run its code is to call ExecuteProcess. For example, an invisible control does not respond when using the shortcut. For example, an active button made invisible does not respond when using the shortcut.
To restore the previous status of the control, all you have to do is re-use ..Visible.
WINDEVWindows Mobile

Menu options

..State is used to find out whether the menu option is enabled or grayed. To define whether the menu option is visible, use ..Visible.
Versions 20 and later
iPhone/iPad ..State = Grayed used on an option of a popup menu is used to make this option invisible.
New in version 20
iPhone/iPad ..State = Grayed used on an option of a popup menu is used to make this option invisible.
iPhone/iPad ..State = Grayed used on an option of a popup menu is used to make this option invisible.
Windows Mobile To optimize the size of the WINDEV Mobile framework installed on the mobile device (Pocket PC), only the properties can be used to handle the menu options by programming.
The equivalence table is as follows:
Available functions
in WINDEV
Equivalent properties
MenuUnmark
MenuIsMarked
MenuMark
Checked
MenuStateState
MenuInvisibleVisible
MenuSelectMinusState
MenuSelectPlusState
MenuLabelCaption

Limits

WINDEVWEBDEV - Server codeReports and QueriesiPhone/iPadWindows MobileUniversal Windows 10 App ..State has no effect on the reports.
Java ..State only applies to the following elements:
  • Button.
  • Static control.
  • Edit control.
  • Image.
  • Check Box.
  • Radio button.
  • List Box.
  • Combo Box.
  • TreeView.
  • Tab.
  • Window.
  • Table.
  • Table column.
  • Supercontrol.
Universal Windows 10 App ..State has no effect on the HTML controls.
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