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).
Note: 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 the PHP sites.

New in version 16

This property is now available for the PHP sites.

This property is now available for the PHP sites.

Versions 17 and later

This property is now available for the iPhone/iPad applications.

New in version 17

This property is now available for the 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 Name>[<Row Subscript>]..Selected

<Result>: Boolean

True if the element is selected,
False otherwise.

<Control name>: Character string (with or without quotes)

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 Name>[<Row Subscript>]..Selected = <Selection>

<Control name>: Character string (with or without quotes)

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 name>..Selected

<Result>: Boolean

True if the option is selected,
False otherwise.

<Option name>: Character string (with or without quotes)

Name of the menu option to use.

Selecting a menu option with tab Hide the details

<Option name>..Selected = <Selection>

<Option name>: Character string (with or without quotes)

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

For a multi-selection List Box control, ..Selected is used to:

find out the selected rows.
select several rows.

For a single-selection List Box control, when a row is selected by ..Selected, the row that was previously selected is automatically de-selected.

The multi-selection List Box controls are not available.

Limits

..Selected only applies to the:

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.

..Selected only applies to the List Box controls.