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 allows you to directly find out whether the row corresponding to the specified subscript is selected or not.
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 subscript>].Selected

<Result>: Boolean

True if the element is selected,
False otherwise.

<Control used>: Control name

Name of control to use:
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 subscript is not specified, allows you to find out whether the column is selected.
New in version 16
Column name: used to find out whether the cell is selected. If the row subscript is not specified, allows you to find out whether the column is selected.
Column name: used to find out whether the cell is selected. If the row subscript is not specified, allows you to find out whether the column is selected.

<Row subscript>: Integer

Subscript of the row to use.

Selecting an element Hide the details

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

<Control used>: Control name

Name of control to use:
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 subscript is not specified, enables you to select or not the table column.
New in version 16
Column name: used to select a cell or not. If the row subscript is not specified, enables you to select or not the table column.
Column name: used to select a cell or not. If the row subscript is not specified, enables you to select or not the table column.

<Row subscript>: Integer

Subscript 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 multiselection List Box control

In the case of an List Box control multiselection, the Property Selected allows to:

find out the selected rows.
select several rows.

In the case of a single List Box control selection, when an row is selected with the Property Selected, the previously selected row is automatically deselected.

The multi-selection List Box controls are not available.

Limits

The Property Selected 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 Property Selected applies to list fields only.