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。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
標頭 |
|