PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • 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
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
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:
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
MemoryAllows you to find out whether the specified control is a memory or browsing ListView control.
ListViewModeChanges the display mode of the ListView control (listview mode, list box mode, panorama mode).
OccurrenceAllows you to find out the number of rows found in a ListView control.
VerticalOrientationAllows you to find out and modify the orientation of a ListView control.
FillTypeAllows you to find out how a ListView control is filled (file, memory, variable).
DisplayedValueAllows you to find out the value of the current row or the value of a specific row in the ListView control.
EmptyAllows you to find out whether a ListView control is empty.
Memory listviews only
SortedAllows 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
BrowsedFileAllows you to find out and modify the file or the query used to display records in the browsing listviews.
AutoBrowseAllows you to find out whether a browse performed in a browsing ListView control is an automatic browse or a programmed browse.
DisplayedItemAllows you to identify or modify the item corresponding to the caption displayed in a ListView control.
DisplayedItemImageAllows you to find out and modify the item corresponding to the image displayed in a ListView control.
StoredItemAllows you to find out and modify the stored item of a ListView control.
BrowsedItemAllows 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.
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment