DLM_GETNEXTITEM

项目
11/18/2015

4/8/2010

The DLM_GETNEXTITEM message is sent by an application to retrieve the net item in the document list. This message translates into a Windows Embedded CE SendMessage function of the LVM_GETNEXTITEM message to the document list view window.

Syntax

DLM_GETNEXTITEM
    wParam = (WPARAM) (int) iStart; 
    lParam = (MAKELPARAM) ((UINT) flags, 0);

Parameters

iStart
Index of the item to begin the search with, or -1 to find the first item that matches the specified flags. The specified item itself is excluded from the search.

Flags
Specifies the relationship to the item specified in iStart. See Remarks for more information about this parameter.

Return Value

This message returns the index of the next list item if another list item is successfully found, or returns -1 if the next list item could not be identified (failure).

Remarks

The following value specifies the relationship of flags to the item specified in iStart.

Value	Description
LVNI_ALL	Searches for a subsequent item by index (the default value).

The physical relationship of flags to iStart is specified with one of the following values.

Value	Description
LVNI_ABOVE	Searches for an item that is above the specified item.
LVNI_BELOW	Searches for an item that is below the specified item.
LVNI_TOLEFT	Searches for an item to the left of the specified item.
LVNI_TORIGHT	Searches for an item to the right of the specified item.

The state of the item to find is specified with one or a combination of the following values of flag:

LVNI_CUT
The item has the LVIS_CUT state flag set.

LVNI_DROPHILITED
The item has the LVIS_DROPHILITED state flag set.

LVNI_FOCUSED
The item has the LVIS_FOCUSED state flag set.

LVNI_SELECTED
The item has the LVIS_SELECTED state flag set.

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

Requirements

Header	doclist.h
Library	doclist.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later

通过