макрос ListView_GetNextItemIndex (commctrl.h)

2024-10-24

Получает индекс элемента в определенном элементе управления представления списка, который имеет указанные свойства и связь с другим конкретным элементом. Используйте этот макрос или явно отправьте сообщение LVM_GETNEXTITEMINDEX.

Синтаксис

BOOL ListView_GetNextItemIndex(
  [in]      HWND        hwnd,
  [in, out] LVITEMINDEX *plvii,
            LPARAM      flags
);

Параметры

[in] hwnd

Тип: HWND

Дескриптор элемента управления "Представление списка".

[in, out] plvii

Тип: LVITEMINDEX*

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

flags

Тип: LPARAM

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

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

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

Тип: BOOL

Возвращает 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