CListCtrl::GetNextItem

更新 : 2007 年 11 月

指定したプロパティと、指定したアイテムとの間に指定した関係を持つリスト ビュー アイテムを検索します。

int GetNextItem(
   int nItem,
   int nFlags 
) const;

パラメータ

  • nItem
    検索を開始するアイテムのインデックス。指定したフラグに一致する最初のアイテムを検索するときは -1 を指定します。指定したアイテム自身は検索の対象に含まれません。

  • nFlags
    要求されたアイテムと指定したアイテムの幾何学的関係と、要求されたアイテムの状態。幾何学的関係は、次の値の 1 つを指定できます。

    • LVNI_ABOVE   指定したアイテムの上にあるアイテムを検索します。

    • LVNI_ALL   インデックス順で次のアイテムを検索します (既定値)。

    • LVNI_BELOW   指定したアイテムの下にあるアイテムを検索します。

    • LVNI_TOLEFT   指定したアイテムの左にあるアイテムを検索します。

    • LVNI_TORIGHT   指定したアイテムの右にあるアイテムを検索します。

  • 状態は指定しなくてもかまいません。指定するときは次の値を組み合わせて指定します。

    • LVNI_DROPHILITED   アイテムに LVIS_DROPHILITED 状態フラグが設定されている

    • LVNI_FOCUSED   アイテムに LVIS_FOCUSED 状態フラグが設定されている

    • LVNI_SELECTED   アイテムに LVIS_SELECTED 状態フラグが設定されている

    指定した状態フラグがアイテムに設定されていない場合は、次のアイテムを続けて検索します。

戻り値

正常終了した場合は次のアイテムのインデックスを返します。それ以外の場合は -1 を返します。

必要条件

ヘッダー : afxcmn.h

参照

参照

CListCtrl クラス

階層図

CListCtrl::GetItem

その他の技術情報

CListCtrl のメンバ