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 で指定された項目との関係。 これは、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 以降: 現在のグループを検索します。
項目に指定された状態フラグがすべて設定されていない場合、検索は次の項目で続行されます。

戻り値

なし

解説

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

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー commctrl.h

こちらもご覧ください

LVM_GETNEXTITEM