сообщение LVM_GETNEXTITEM

Выполняет поиск элемента представления списка, который имеет указанные свойства и имеет указанную связь с указанным элементом. Это сообщение можно отправить явным образом или с помощью макроса ListView_GetNextItem .

Параметры

wParam

Индекс элемента, с которым начинается поиск, или -1, чтобы найти первый элемент, соответствующий указанным флагам. Сам указанный элемент исключается из поиска.

lParam

Указывает связь с элементом, указанным в wParam. Это может быть одно или сочетание следующих значений:

Значение	Значение
Выполняет поиск по индексу.
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.
Состояние искомого элемента можно указать с помощью одного или сочетания следующих значений:
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