Help Center

CListView.GetNextItemIndexmethod

Gets the index of the item in a particular list-view control that has the specified properties and relationship to another specific item.

WindowsmethodCListView.incdocumented

Syntax

FUNCTION GetNextItemIndex (BYVAL hListView AS HWND, BYVAL plvii AS LVITEMINDEX PTR, BYVAL flags AS ..LPARAM) AS LONG
FUNCTION GetNextItemIndex (BYVAL hListView AS HWND, BYREF lvii AS LVITEMINDEX, BYVAL flags AS ..LPARAM) AS LONG

Parameters

NameDescription
hListViewHandle to the ListView control.
plviiA pointer to the LVITEMINDEX structure with which the item begins the search, or -1 to find the first item that matches the specified flags. The calling process is responsible for allocating this structure and setting its members.
lviiA LVITEMINDEX structure with which the item begins the search, or -1 to find the first item that matches the specified flags. The calling process is responsible for allocating this structure and setting its members.
flagsThe relationship to the item specified in parameter plvii. This can be one or a combination of the following values:

Return value

Returns TRUE if successful, or FALSE otherwise.

Description

Gets the index of the item in a particular list-view control that has the specified properties and relationship to another specific item.

If an item does not have all of the specified state flags set, the search continues with the next item.

Remarks

Note that the following flags, for use only with Windows Vista, are mutually exclusive of any other flags in use: LVNI_PREVIOUS, LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK, and LVNI_STATEMASK.

Reference

  • Include file CListView.inc
  • Defined in AfxNova/CListView.inc:2283
  • Documented in Windows/WIndows Controls/CListView Class.md
  • Topic: CListView Class