Поделиться через

сообщение 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