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

Статья
10/24/2024

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

Синтаксис

BOOL ListView_GetItem(
   HWND     hwnd,
   LPLVITEM pitem
);

Параметры

hwnd

Тип: HWND

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

pitem

Тип: LPLVITEM

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

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

Тип: BOOL

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

Замечания

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

Если флаг LVIF_TEXT задан в маске член структуры LVITEM, элемент pszText должен указывать на допустимый буфер, а элемент cchText Max должен иметь значение количества символов в этом буфере. Приложения не должны предполагать, что текст обязательно помещается в указанный буфер. Элемент управления может вместо этого изменить элемент pszText элемент структуры, чтобы указать на новый текст, а не поместить его в буфер.

Если элемент маски указывает значение LVIF_STATE, элемент stateMask должен указать биты состояния элемента для извлечения. В выходных данных элемент состояния содержит значения указанных битов состояния.

Требования

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

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