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


сообщение LVM_GETITEM

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

Параметры

wParam

Должен равняться нулю.

lParam

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

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

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

Комментарии

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

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

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

Требования

Требование Значение
Минимальная версия клиента
Windows Vista [только классические приложения]
Минимальная версия сервера
Windows Server 2003 [только классические приложения]
Заголовок
Commctrl.h
Имя в кодировке Юникод и ANSI
LVM_GETITEMW (Юникод) и LVM_GETITEMA (ANSI)