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


LVM_GETNEXTITEMINDEX сообщение

Извлекает индекс элемента в указанном элементе управления представлением списка, который соответствует заданным свойствам и отношениям с другим элементом. Отправьте это сообщение явным образом или с помощью макроса ListView_GetNextItemIndex .

Параметры

wParam [in, out]

Указатель на структуру LVITEMINDEX для элемента, с которым начинается поиск, или значение -1 для поиска первого элемента, соответствующего указанным флагам. Процесс вызова отвечает за выделение этой структуры и настройку ее членов.

lParam

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

Значение Значение
Выполняет поиск по индексу.
LVNI_ALL
Выполняет поиск последующего элемента по индексу( значение по умолчанию).
Выполняет поиск по физической связи с индексом элемента, с которого начинается поиск.
LVNI_ABOVE
Выполняет поиск элемента, который находится выше указанного элемента.
LVNI_BELOW
Выполняет поиск элемента, который находится ниже указанного элемента.
LVNI_TOLEFT
Выполняет поиск элемента слева от указанного элемента.
LVNI_PREVIOUS
Windows Vista и более поздних версий: Выполняет поиск элемента, упорядоченного перед элементом, указанным в wParam. Флаг LVNI_PREVIOUS не является направленным (LVNI_ABOVE найдет элемент, расположенный выше, в то время как LVNI_PREVIOUS найдет элемент, упорядоченный ранее.) Флаг LVNI_PREVIOUS в основном меняет логику поиска, выполняемого LVM_GETNEXTITEM или LVM_GETNEXTITEMINDEX сообщениями.
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 и более поздних версий: Выполните поиск в текущей группе.
Если для элемента не заданы все указанные флаги состояния, поиск продолжается с помощью следующего элемента.

Возвращаемое значение

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае.

Комментарии

Обратите внимание, что следующие флаги для использования только в Windows Vista являются взаимоисключающими для всех других используемых флагов: LVNI_PREVIOUS, LVNI_VISIBLEONLY, LVNI_SAMEGROUPONLY, LVNI_VISIBLEORDER, LVNI_DIRECTIONMASK и LVNI_STATEMASK.

Требования

Требование Значение
Минимальная версия клиента
Windows Vista [только классические приложения]
Минимальная версия сервера
Windows Server 2008 [только классические приложения]
Заголовок
Commctrl.h

См. также раздел

LVM_GETNEXTITEM