ListView_GetNextItemIndex 巨集 (commctrl.h)
取得特定清單檢視控件中專案索引,該控件具有指定屬性與另一個特定項目的關聯性。 使用此宏或明確傳送 LVM_GETNEXTITEMINDEX 訊息。
語法
void ListView_GetNextItemIndex(
[in] hwnd,
[in, out] plvii,
flags
);
參數
[in] hwnd
類型: HWND
清單檢視控件的句柄。
[in, out] plvii
類型: LVITEMINDEX*
項目開始搜尋的 LVITEMINDEX 結構的指標,或 -1 尋找符合指定旗標的第一個專案。 呼叫進程負責配置此結構並設定其成員。
flags
類型: LPARAM
與參數 plvii 中指定的項目關聯性。 這可以是下列值的其中一個或組合:
值 | 意義 |
---|---|
|
|
|
依索引搜尋後續專案,預設值。 |
|
|
|
搜尋位於指定專案上方的專案。 |
|
搜尋位於指定專案下方的專案。 |
|
搜尋指定專案左邊的專案。 |
|
Windows Vista 和更新版本: 搜尋前一個指定項目的專案。 LVNI_PREVIOUS旗標不是方向 (LVNI_ABOVE 會找到位於上方的專案,而LVNI_PREVIOUS會尋找在之前排序的專案。) LVNI_PREVIOUS 旗標基本上會反轉透過LVM_GETNEXTITEM或LVM_GETNEXTITEMINDEX訊息執行的搜尋邏輯。 |
|
搜尋指定專案右邊的專案。 |
|
Windows Vista 和更新版本: 具有值的方向旗標遮罩,如下所示:LVNI_ABOVE |LVNI_BELOW |LVNI_TOLEFT |LVNI_TORIGHT。 |
|
|
|
項目已設定 LVIS_CUT 狀態旗標。 |
|
項目已設定 LVIS_DROPHILITED 狀態旗標 |
|
項目已設定 LVIS_FOCUSED 狀態旗標。 |
|
項目已設定 LVIS_SELECTED 狀態旗標。 |
|
Windows Vista 和更新版本: 具有值的狀態旗標遮罩,如下所示:LVNI_FOCUSED |LVNI_SELECTED |LVNI_CUT |LVNI_DROPHILITED。 |
|
|
|
Windows Vista 和更新版本: 搜尋可見的順序。 |
|
Windows Vista 和更新版本: 搜尋可見的專案。 |
|
Windows Vista 和更新版本: 搜尋目前的群組。 |
|
傳回值
無
備註
請注意,下列旗標僅適用於 Windows Vista,與使用中的任何其他旗標互斥:LVNI_PREVIOUS、LVNI_VISIBLEONLY、LVNI_SAMEGROUPONLY、LVNI_VISIBLEORDER、LVNI_DIRECTIONMASK和LVNI_STATEMASK。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | commctrl.h |