LVM_GETNEXTITEMINDEX メッセージ

  • [アーティクル]

指定したプロパティと別のアイテムとのリレーションシップと一致する、指定したリスト ビュー コントロール内のアイテムのインデックスを取得します。 このメッセージを明示的に送信するか、 ListView_GetNextItemIndex マクロを使用して送信します。

パラメーター

wParam [in, out]

検索を開始する項目の LVITEMINDEX 構造体へのポインター。指定したフラグに一致する最初の項目を検索する場合は -1。 呼び出し元のプロセスは、この構造体を割り当て、そのメンバーを設定する役割を担います。

lParam

パラメーター wParam にリストされている項目とのリレーションシップを指定します。 これには、次の値の 1 つまたは組み合わせを指定できます。

値 説明
インデックスで検索します。
LVNI_ALL
 インデックス (既定値) で後続の項目を検索します。
検索を開始するアイテムのインデックスとの物理的な関係で検索します。
LVNI_ABOVE
 指定した項目の上にある項目を検索します。
LVNI_BELOW
 指定した項目の下にある項目を検索します。
LVNI_TOLEFT
 指定した項目の左側にある項目を検索します。
LVNI_PREVIOUS
 Windows Vista 以降:wParam で指定された項目の前に並べ替えられた項目を検索します。 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 以降: 現在のグループを検索します。
アイテムに指定した状態フラグがすべて設定されていない場合、検索は次の項目で続行されます。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。

解説

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

必要条件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
Header
Commctrl.h

関連項目

LVM_GETNEXTITEM