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 つまたは次の値の組み合わせにすることができます。
値 | 意味 |
---|---|
|
|
|
後続の項目をインデックス (既定値) で検索します。 |
|
|
|
指定した項目の上にある項目を検索します。 |
|
指定した項目の下にある項目を検索します。 |
|
指定した項目の左側にある項目を検索します。 |
|
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 |