сообщение 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 [только классические приложения] |
Заголовок |
|
Имя в кодировке Юникод и ANSI |
LVM_GETITEMW (Юникод) и LVM_GETITEMA (ANSI) |