Selected (Property)

Find out whether a row is selected (in a List Box, ListView or Table control) and select a row (in a List Box, ListView or Table control).
Remark: Unlike ListSelect, this property is used to directly find out whether the row that corresponds to the specified index is selected.
Versions 16 and later
Find out whether a column or a cell found in a Table control is selected and to select a column or a cell found in a Table control (for the Table controls with row or column selection).
New in version 16
Find out whether a column or a cell found in a Table control is selected and to select a column or a cell found in a Table control (for the Table controls with row or column selection).
Find out whether a column or a cell found in a Table control is selected and to select a column or a cell found in a Table control (for the Table controls with row or column selection).
Find out whether a tab menu option is selected and to select a tab menu option.

Versions 16 and later

This property is now available for PHP sites.

New in version 16

This property is now available for PHP sites.

This property is now available for PHP sites.

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Example

// Selects row 5 in the CITY List Box control
LIST_City[5].Selected = True

// Modifies the selected menu option
OPT_MobileOption.Selected = True

Syntax

Finding out whether an element is selected Hide the details

<Result> = <Control used>[<Row index>].Selected

<Result>: Boolean

True if the element is selected,
False otherwise.

<Control used>: Control name

Name of the control to be used:
Name of List Box, ListView or Table control: used to find out whether the row is selected.
Versions 16 and later
Column name: used to find out whether the cell is selected. If the row index is not specified, allows you to determine whether the column is selected.
New in version 16
Column name: used to find out whether the cell is selected. If the row index is not specified, allows you to determine whether the column is selected.
Column name: used to find out whether the cell is selected. If the row index is not specified, allows you to determine whether the column is selected.

<Row index>: Integer

Index of the row to use.

Selecting an element Hide the details

<Control used>[<Row index>].Selected = <Selection>

<Control used>: Control name

Name of the control to be used:
Name of List Box, ListView or Table control: used to select a row or not.
Versions 16 and later
Column name: used to select a cell or not. If the row index is not specified, enables you to select or deselect the table column.
New in version 16
Column name: used to select a cell or not. If the row index is not specified, enables you to select or deselect the table column.
Column name: used to select a cell or not. If the row index is not specified, enables you to select or deselect the table column.

<Row index>: Integer

Index of the row to use.

<Selection>: Boolean

True if the element must be selected,
False otherwise.

Finding out whether a menu option with tab is selected Hide the details

<Result> = <Option used>.Selected

<Result>: Boolean

True if the option is selected,
False otherwise.

<Option used>: Option name

Name of the menu option to use.

Selecting a menu option with tab Hide the details

<Option used>.Selected = <Selection>

<Option used>: Option name

Name of the option to select.

<Selection>: Boolean

True if the option must be selected,
False otherwise.

Remarks

Single-selection and multi-selection List Box control

In multi-selection List Box controls, the Selected property is used to:

find out the selected rows.
select several rows.

In single-selection List Box controls, when a row is selected with the Selected property, the previously selected row is automatically deselected.

The multi-selection List Box controls are not available.

Limits

The Selected property applies only to:

Table controls.
List Box controls.
ListView controls.
Versions 16 and later
Table columns.
New in version 16
Table columns.
Table columns.
Versions 16 and later
Table cells.
New in version 16
Table cells.
Table cells.

The Selected property applies only to List Box controls.