LVM_GETNEXTITEM訊息

搜尋具有指定屬性的清單檢視專案，並具有指定之專案的指定關聯性。 您可以明確傳送此訊息，或使用 ListView_GetNextItem 宏。

參數

wParam

用來開始搜尋的專案索引，或 -1，以尋找符合指定旗標的第一個專案。 指定的專案本身會從搜尋中排除。

lParam

指定 wParam中所指定專案的關聯性。 這可以是下列值的其中一個或組合：

值	意義
依索引搜尋。
LVNI_ALL	依索引搜尋後續專案，預設值。
LVNI_PREVIOUS	Windows Vista 和更新版本： 搜尋 在 wParam中指定的專案之前排序的專案。 LVNI_PREVIOUS旗標不是方向 (LVNI_ABOVE會尋找位於上方的專案，而LVNI_PREVIOUS會尋找之前排序的專案。) LVNI_PREVIOUS 旗標基本上會反轉 LVM_GETNEXTITEM 或 LVM_GETNEXTITEMINDEX 訊息所執行的搜尋邏輯。
依實體關聯性搜尋要開始搜尋之專案的索引。
LVNI_ABOVE	搜尋位於指定專案上方的專案。
LVNI_BELOW	搜尋位於指定專案下方的專案。
LVNI_TOLEFT	搜尋指定專案左邊的專案。
LVNI_TORIGHT	搜尋指定專案右邊的專案。
LVNI_DIRECTIONMASK	Windows Vista 和更新版本： 具有值的方向旗標遮罩，如下所示：LVNI_ABOVE |LVNI_BELOW |LVNI_TOLEFT |LVNI_TORIGHT。
可以使用下列值之一或組合來指定要尋找的專案狀態：
LVNI_CUT	專案已設定 LVIS_CUT 狀態旗標。
LVNI_DROPHILITED	專案已設定 LVIS_DROPHILITED 狀態旗標
LVNI_FOCUSED	專案已設定 LVIS_FOCUSED 狀態旗標。
LVNI_SELECTED	專案已設定 LVIS_SELECTED 狀態旗標。
LVNI_STATEMASK	Windows Vista 和更新版本： 狀態旗標遮罩，值如下：LVNI_FOCUSED |LVNI_SELECTED |LVNI_CUT |LVNI_DROPHILITED。
依專案或群組的外觀搜尋
LVNI_VISIBLEORDER	Windows Vista 和更新版本： 搜尋可見的順序。
LVNI_VISIBLEONLY	Windows Vista 和更新版本： 搜尋可見的專案。
LVNI_SAMEGROUPONLY	Windows Vista 和更新版本： 搜尋目前的群組。
如果專案未設定所有指定的狀態旗標，搜尋會繼續進行下一個專案。

傳回值

如果成功，則傳回下一個專案的索引，否則傳回 -1。

備註

請注意，下列旗標僅適用于 Windows Vista，與其他任何使用中的旗標互斥：LVNI_VISIBLEONLY、LVNI_SAMEGROUPONLY、LVNI_VISIBLEORDER、LVNI_DIRECTIONMASK和LVNI_STATEMASK。

規格需求