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で指定された項目との関係。 これには、次の値の 1 つまたは組み合わせを指定できます。

価値 意味
インデックスで検索します。
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。
検索する項目の状態は、次の値の 1 つまたは組み合わせで指定できます。
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 を返し、それ以外の場合は FALSE 返します。

備考

Windows Vista でのみ使用する次のフラグは、使用されている他のフラグ (LVNI_PREVIOUS、LVNI_VISIBLEONLY、LVNI_SAMEGROUPONLY、LVNI_VISIBLEORDER、LVNI_DIRECTIONMASK、およびLVNI_STATEMASK) とは相互に排他的であることに注意してください。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー commctrl.h

関連項目

LVM_GETNEXTITEM