Handling a ListView control by programming

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Overview
Initializing a ListView control
Initializing an item
Filling a ListView control
Selecting an element in a ListView control
Selecting the element of row whose subscript is
Positioning on the last element of ListView control
Retrieving the element selected in the ListView control
Retrieving the subscript of selected element
Retrieving the value of selected element
Properties specific to the management of ListView controls

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Handling a ListView control by programming

Overview

WINDEV allows you to handle a ListView control by programming. To do so, use the variable the of ListView control in the code. This variable is a numeric variable.

The variable of ListView control:

corresponds to the name of ListView control.
is initialized with the subscript of the element selected in the ListView control.

Remark: To handle a ListView element not associated with any stored item, use the following syntax:

<Champ Liste image> [ <Indice de l'élément>]

Initializing a ListView control

Initializing an item

To initialize an element found in a ListView control, use ListAdd.

ListAdd(LSI_ListeImage1, "Soleil", "C:\IMG\Soleil.JPG")
ListAdd(LSI_ListeImage1, Photo)

Filling a ListView control

To initialize a ListView control, an iteration loop must be used to initialize all control elements.

Indice est un entier
POUR Indice = <Position Début> A <Position Fin>
ListeAjoute(<Champ Liste image>, <Valeur>, <Image>)
FIN

i is int
FOR i = 1 TO 52
ListAdd(LSI_ListeImage1, NOM[i], Image[i])
END

Selecting an element in a ListView control

Selecting the element of row whose subscript is <Subscript>

To select the element found at <Subscript> row, use:

the direct assignment:

<Nom du champ Liste image> = Indice
ListSelectPlus:

ListeSelectPlus(<Champ Liste image>, <Indice>)

Positioning on the last element of ListView control

To position on the last element of ListView control, use:

Occurrence:

<Champ Liste image>.Occurrence
or the function ListSelectPlus associated with Property Occurrence:

ListeSelectPlus(<Champ Liste image>, <Champ Liste image>.Occurrence)
ListCount:

ListeOccurrence(<Champ Liste image>)

Retrieving the element selected in the ListView control

Retrieving the subscript of selected element

To retrieve the subscript of selected element, use:

the direct reading of element:

Indice = <Champ Liste image>
ListSelect:

Indice = ListeSelect(<Champ Liste image>)

Remark: For multiselection ListView controls, ListSelect is used to retrieve the selected elements.

// Récupérer les éléments d'un champ Liste image multisélection
Rang is int = 0 // numéro de la sélection
Indice is int = 0 // indice de l'élément sélectionné
LOOP
Rang = Rang + 1
Indice = ListSelect(LSI_ListeImage1, Rang)
IF Indice = -1 THEN BREAK
END

Retrieving the value of selected element

To retrieve the value of selected element, use one of the following syntaxes:

Syntax 1:

Indice est un entier = <Champ Liste image>
<Variable> = <Champ Liste image>[Indice]
Syntax 2:

<Variable> = <Champ Liste image>[<Champ Liste image>]
Syntax 3: DisplayedValue property

<Variable> = <Champ Liste image>.ValeurAffichée

Caution: The value stored in programming can differ from the displayed value. To find out the stored value corresponding to one of the rows found in the ListView control, use StoredValue.

Properties specific to the management of ListView controls

The following properties are used to manage the ListView controls:


All types of ListView controls
Memory	Allows you to find out whether the specified control is a memory or browsing ListView control.
ListViewMode	Changes the display mode of the ListView control (listview mode, list box mode, panorama mode).
Occurrence	Allows you to find out the number of rows found in a ListView control.
VerticalOrientation	Allows you to find out and modify the orientation of a ListView control.
FillType	Allows you to find out how a ListView control is filled (file, memory, variable).
DisplayedValue	Allows you to find out the value of the current row or the value of a specific row in the ListView control.
Empty	Allows you to find out whether a ListView control is empty.
Memory ListView control only
Sorted	Allows you to find out whether a memory ListView control is sorted and to sort a memory ListView control (according to the captions of the elements).
Browsing ListView control only
BrowsedFile	Allows you to find out and modify the data file or the query used to display records in the browsing ListView controls.
AutoBrowse	Allows you to find out whether a browse performed in a browsing ListView control is an automatic browse or a programmed browse.
DisplayedItem	Allows you to identify or modify the item corresponding to the caption displayed in a ListView control.
DisplayedItemImage	Allows you to find out and modify the item corresponding to the image displayed in a ListView control.
StoredItem	Allows you to find out and modify the stored item of a ListView control.
BrowsedItem	Allows you to find out and modify the item used for the automatic browse of ListView controls.

For a complete list of WLanguage properties that can be used with a control of type ListView, see Properties associated with the ListView control.