リストビューコントロールから、指定された属性を持ち、指定されたアイテムと指定された関係にあるアイテムを検索します。検索開始位置と検索方向を指定できます。
このメッセージを送信するには SendMessage 関数を使います。
#define LVM_GETNEXTITEM 0x100C wParam = iStart; lParam = flags;
検索を開始するアイテムのインデックスを指定します。ここで指定されたアイテム自体は検索の対象から除かれます。最初のアイテムから検索する場合には -1 を指定します。
検索する属性と、検索方向を指定します。
検索方法を指定するために、以下の値のいずれか1つを指定します。
| 値 | 意味 |
|---|---|
| 0x0000 (LVNI_ALL) | 指定されたアイテムの後に続くアイテムを検索します。（デフォルト） |
| 0x0100 (LVNI_ABOVE) | 指定されたアイテムの上にあるアイテムを検索します。 |
| 0x0200 (LVNI_BELOW) | 指定されたアイテムの下にあるアイテムを検索します。 |
| 0x0400 (LVNI_TOLEFT) | 指定されたアイテムの左にあるアイテムを検索します。 |
| 0x0800 (LVNI_TORIGHT) | 指定されたアイテムの右にあるアイテムを検索します。 |
検索する属性を指定するために、以下の値の組み合わせを指定します。以下のいずれの値も指定しない場合は、指定した検索方向にしたがって次のアイテムを検索します。
| 値 | 意味 |
|---|---|
| 0x0001 (LVNI_FOCUSED) | フォーカスを持つアイテムを検索します。 |
| 0x0002 (LVNI_SELECTED) | 選択されているアイテムを検索します。 |
| 0x0004 (LVNI_CUT) | カット・アンド・ペーストの対象としてマークされているアイテムを検索します。 |
| 0x0008 (LVNI_DROPHILITED) | ドラッグ・アンド・ドロップのターゲットとしてハイライト表示されているアイテムを検索します。 |
成功すると該当するアイテムのインデックスが返ります。
該当するアイテムが見つからない場合は -1 が返ります。
Windows 95 以降 / Windows NT 3.51 以降