LVM_GETNEXTITEM メッセージ

  • [アーティクル]

指定したプロパティを持ち、指定したアイテムとの関係を持つリスト ビュー アイテムを検索します。 このメッセージは、明示的に送信することも、 ListView_GetNextItem マクロを使用して送信することもできます。

パラメーター

wParam

検索を開始する項目のインデックス。指定したフラグに一致する最初の項目を検索する場合は -1。 指定した項目自体は検索から除外されます。

lParam

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

値 説明
インデックスで検索します。
LVNI_ALL
 インデックス (既定値) で後続の項目を検索します。
LVNI_PREVIOUS
 Windows Vista 以降:wParam で指定された項目の前に並べ替えられた項目を検索します。 LVNI_PREVIOUS フラグは方向ではありません (LVNI_ABOVEは上に配置されたアイテムを見つけますが、LVNI_PREVIOUSは前に順序付けされたアイテムを見つけます)。LVNI_PREVIOUS フラグは、基本的に、 LVM_GETNEXTITEM または LVM_GETNEXTITEMINDEX メッセージによって実行される検索のロジックを反転します。
検索を開始するアイテムのインデックスとの物理的な関係で検索します。
LVNI_ABOVE
 指定した項目の上にある項目を検索します。
LVNI_BELOW
 指定した項目の下にある項目を検索します。
LVNI_TOLEFT
 指定した項目の左側にある項目を検索します。
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 以降: 現在のグループを検索します。
アイテムに指定した状態フラグがすべて設定されていない場合、検索は次の項目で続行されます。

戻り値

成功した場合は次の項目のインデックスを返し、それ以外の場合は -1 を返します。

解説

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

要件

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