Handling a ListView control by programming

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Overview
Initializing a ListView control
Initializing an element
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 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.

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

<ListView Name> [ <Element Subscript>]

Initializing a ListView control

Initializing an element

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

ListAdd(LSV_ListView1, "Sun", "C:\IMG\Sun.JPG")
ListAdd(LSV_ListView1, Photo)

Filling a ListView control

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

Subscript is int
FOR Subscript = <Start Position> TO <End Position>
ListAdd(<ListView Name>, <Value>, <Image>)
END

i is int
FOR i = 1 TO 52
ListAdd(LSV_ListView1, NAME[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:

<ListView Name> = Subscript
ListSelectPlus:

ListSelectPlus(<ListView Name>, <Subscript>)

Positioning on the last element of ListView control

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

..Occurrence:

<ListView Name>..Occurrence
ListSelectPlus associated with ..Occurrence:

ListSelectPlus(<ListView Name>, <ListView Name>..Occurrence)
ListCount:

ListCount(<ListView Name>)

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:

Subscript = <ListView Name>

ListSelect:

Subscript = ListSelect(ListView Name)

Note: For the multi-selection ListView controls, ListSelect is used to retrieve the selected elements.

// Retrieve the elements found in a multi-selection ListView control
Rank is int = 0 // selection number
Subscript is int = 0 // subscript of selected element
LOOP
Rank = Rank + 1
Subscript = ListSelect(LSV_ListView1, Rank)
IF Subscript = - 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:

Subscript is int = <ListView Name>
<Variable> = <ListView Name>[Subscript]

Syntax 2:

<Variable> = <ListView Name>[<ListView Name>]

Syntax 3: ..DisplayedValue

<Variable> = <ListView Name>..DisplayedValue

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:


Any type of listview
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 listviews 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 listviews only
BrowsedFile	Allows you to find out and modify the file or the query used to display records in the browsing listviews.
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.

To find out the entire list of WLanguage properties that can be used with a ListView control, see Properties associated with the ListView control.