共用方式為

ListView_GetNextItemIndex巨集 （commctrl.h）

  • 發行項

取得特定清單檢視控件中專案索引，該控件具有指定屬性與另一個特定項目的關聯性。 使用此巨集或明確傳送 LVM_GETNEXTITEMINDEX 訊息。

語法

BOOL ListView_GetNextItemIndex(
  [in]      HWND        hwnd,
  [in, out] LVITEMINDEX *plvii,
            LPARAM      flags
);

參數

[in] hwnd

類型：HWND

清單檢視控件的句柄。

[in, out] plvii

類型：LVITEMINDEX*

LVITEMINDEX 結構的指標，該專案會開始搜尋，或 -1 尋找符合指定旗標的第一個專案。 呼叫進程負責配置此結構並設定其成員。

flags

類型：LPARAM

參數中指定的項目關聯性 plvii。 這可以是下列值的其中一個或組合：

價值 意義
依索引搜尋。
LVNI_ALL
 依索引搜尋後續專案，預設值。
依實體關聯性搜尋要開始搜尋之專案的索引。
LVNI_ABOVE
 搜尋指定專案上方的專案。
LVNI_BELOW
 搜尋位於指定專案下方的專案。
LVNI_TOLEFT
 搜尋指定專案左邊的專案。
LVNI_PREVIOUS
 Windows Vista 和更新版本： 搜尋指定專案之前的專案。 LVNI_PREVIOUS旗標不是方向的（LVNI_ABOVE會找到位於上方的專案，而LVNI_PREVIOUS會尋找之前排序的專案。LVNI_PREVIOUS旗標基本上會反轉透過LVM_GETNEXTITEM或LVM_GETNEXTITEMINDEX訊息執行的搜尋邏輯。
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 和更新版本： 搜尋目前的群組。
如果專案未設定所有指定的狀態旗標，搜尋會繼續進行下一個專案。

傳回值

類型：BOOL

如果成功，則傳回 true true，否則會 傳回 false。

言論

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

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 commctrl.h

另請參閱

LVM_GETNEXTITEM