<List Box>.Select (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Equivalence
Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<List Box>.Select (Function)

In french: <Liste>.Select

Returns the subscript of the selected element in a List Box (or ListView) control or in a Combo Box control.

Reminder: The selected element corresponds to the current element onto which the selection bar is displayed.

Remark: <List Box>.Select can be used on:

the browsing or memory List Box controls,
single-selection or multiselection Looper controls.

In this version, <List Box>.Select cannot be used on multiselection List Box controls.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available for Android applications.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available for Android applications.

This function is now available in Windows Store apps mode.

This function is now available for Android applications.

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Subscript of selected element in "LIST_CustomerList"
ResElementSubscript = LIST_CustomerList.Select()

// Rows selected in a multiselection List Box control
i is int = 1
SelectedRowSubscript is int
SubscriptSelectedRow = LIST_List1.Select(1)
WHILE SelectedRowSubscript <> -1
Trace("Row #" + SelectedRowSubscript + " is selected")
i++
SubscriptSelectedRow = LIST_List1.Select(i)
END

// Equivalent to:
// FOR EACH SELECTED ROW OF LIST_List1
// Trace("Row #" + LIST_List1 + " is selected")
// END

Syntax

<Result> = <List Box control>.Select([<Rank>])

<Result>: Integer

Subscript of the element selected in the specified List Box (or Combo Box) control,
-1 if no element is selected.
For a multiselection List Box control, the rank of the selected element must be specified <Rank>).

<List Box control>: Control name

Name of List Box (or Combo Box) control to use.

<Rank>: Optional integer

Rank of selection for a multiselection List Box control. If this parameter is not specified, the subscript of first selected element is returned.
For example: To retrieve the first selected element, the rank will be 1, to retrieve the second selected element, the rank will be 2, etc.

Remarks

Equivalence

The following syntaxes are equivalent:

Subscript is int
Subscript = <List Box control>

and

Subscript = <List Box control>.Select()

Miscellaneous

To find out the subscript of selected element in a Table control, use <Table>.Select.
<List Box>.Select can be used on a "Combo Box" table column.

Component: wd260obj.dll