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

Статья
10/24/2024

Возвращает состояние элемента представления списка. Этот макрос можно использовать или явно отправить сообщение LVM_GETITEMSTATE.

Синтаксис

UINT ListView_GetItemState(
   HWND hwndLV,
   int  i,
   UINT mask
);

Параметры

hwndLV

Тип: HWND

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

i

Тип: int

Индекс элемента представления списка.

mask

Тип: UINT

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

Ценность	Значение
LVIS_CUT	Элемент помечается для операции выреза и вставки.
LVIS_DROPHILITED	Элемент выделен как целевой объект перетаскивания.
LVIS_FOCUSED	Элемент имеет фокус, поэтому он окружен стандартным прямоугольником фокуса. Хотя может быть выбрано несколько элементов, фокус может иметь только один элемент.
LVIS_SELECTED	Выбран элемент. Внешний вид выбранного элемента зависит от того, имеет ли он фокус, а также от системных цветов, используемых для выбора.
LVIS_OVERLAYMASK	Используйте эту маску для получения индекса изображения наложения элемента.
LVIS_STATEIMAGEMASK	Используйте эту маску для получения индекса состояния элемента.

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

Тип: UINT

Возвращает текущее состояние для указанного элемента. Единственными допустимыми битами в возвращаемом значении являются те, которые соответствуют битам, заданным в параметре маски.

Замечания

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	commctrl.h

См. также

ListView_SetItemState

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