<List Box>.SelectPlus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / List Box functions

Last element
Equivalence
Miscellaneous
Selecting an element in a List Box control that belongs to a Looper control

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<List Box>.SelectPlus (Function)

In french: <Liste>.SelectPlus

Selects one or more elements in a List Box, ListView or Combo Box control.

The element is selected but it is not displayed if it is not visible. To make the selected element visible, use <List Box>.Position.

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

Note: The <List Box>.SelectPlus function can be used on both:

List Box controls based on a data file or populated programmatically,
single-selection or multi-selection List Box controls.

Example

// Sélection de l'élément dont l'indice est 7 dans le champ "LISTE_ListeClient"
LISTE_ListeClient.SelectPlus(7)

Syntax

<List Box control>.SelectPlus([<Index 1> [... [, <Index N>]]])

<List Box control>: Control name

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

<Index 1>: Optional integers

Index of the first element to be selected.
If no index is specified, all the elements in the specified List Box or Combo Box control are selected.
<List Box>.SelectPlus has no effect if these parameters correspond to elements that are already selected.

<Index N>: Optional integer

Index of the Nth element to be selected.
If no index is specified, all the elements in the specified List Box or Combo Box control are selected.
<List Box>.SelectPlus has no effect if these parameters correspond to elements that are already selected.

Remarks

Last element

To position on the last element of List Box control, use the following syntax:

<Champ Liste>.SelectPlus(<Champ Liste>.Occurrence)

<Champ Liste> = <Champ Liste>.Occurrence

Equivalence

For a single-selection List Box control without calling gStoredValue, the two following syntaxes are equivalent:

<Champ Liste>.SelectPlus(<Indice>)

and

Miscellaneous

To select an element in a Table control, use <Table>.SelectPlus.
<List Box>.SelectPlus can be used on a "Combo Box" table column.
<List Box>.SelectMinus allows you to deselect the elements of a List Box or Combo Box control.

Selecting an element in a List Box control that belongs to a Looper control

To select an element in a List Box control included in a Looper control, you must:

Declare an attribute of the Looper control on the value of List Box control.
In the code of a button (for example), specify the new attribute value for the requested row.

For example, if the attribute is ATT_SELECTROW, the following code will be used to select the 3rd element of List Box control in the 4th row:

ATT_LIGNESELECT[4] = 3

This code can be used in server code and in browser code.

Component: wd300obj.dll