Handling a ListView control by programming

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

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 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:

<Name of ListView control> [ <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(<Name of ListView control>, <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:

<Name of ListView control> = Subscript
ListSelectPlus:

ListSelectPlus(<Name of ListView control>, <Subscript>)

Positioning on the last element of ListView control

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

..Count:

<Name of ListView control>..Count
ListSelectPlus associated with ..Count:

ListSelectPlus(<Name of ListView control>, <Name of ListView control>..Count)
ListCount:

ListCount(<Name of ListView control>)

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 = <Name of ListView control>
ListSelect:

Subscript = ListSelect(<Name of ListView control>)

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

// Retrieve the elements of a multiselection 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 = <Name of ListView control>
<Variable> = <Name of ListView control>[Subscript]
Syntax 2:

<Variable> = <Name of ListView control>[<Name of ListView control>]
Syntax 3: ..DisplayedValue property

<Variable> = <Name of ListView control>..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:


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).
Count	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 ListView control, see Properties associated with the ListView control.