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

Статья
08/22/2023

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

Синтаксис

void ListView_GetItem(
   hwnd,
   pitem
);

Параметры

hwnd

Тип: HWND

Дескриптор элемента управления list-view.

pitem

Тип: LPLVITEM

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

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

None

Remarks

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

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

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

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	commctrl.h