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