сообщение LVM_SETITEM

  • Статья

Задает некоторые или все атрибуты элемента представления списка. Вы также можете отправить LVM_SETITEM, чтобы задать текст подэлемента. Это сообщение можно отправить явным образом или с помощью макроса ListView_SetItem .

Параметры

wParam

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

lParam

Указатель на структуру LVITEM , содержащую атрибуты нового элемента. Элементы iItem и iSubItem идентифицируют элемент или подэлемент, а элемент mask указывает, какие атрибуты следует задать. Если элемент mask задает значение LVIF_TEXT, то элемент pszText является адресом строки, завершаемой null, а элемент cchTextMax игнорируется. Если элемент mask задает значение LVIF_STATE, элемент stateMask указывает, какие состояния элемента следует изменить, а элемент состояния содержит значения для этих состояний.

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

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

Комментарии

Чтобы задать атрибуты элемента представления списка, задайте для элемента iItem структуры LVITEM индекс элемента, а для элемента iSubItem — нулевое значение. Для элемента можно задать элементы state, pszText, iImage и lParam структуры LVITEM .

Чтобы задать текст подэлемента, задайте элементы iItem и iSubItem для указания конкретного подэлемента и используйте элемент pszText для указания текста. Кроме того, можно использовать макрос ListView_SetItemText для задания текста подэлемента. Невозможно задать состояние или элементы lParam для подэлементов, так как подэлементы не имеют этих атрибутов. В версии 4.70 и более поздних можно задать элемент iImage для дочерних элементов. Изображение подэлемента будет отображаться, если элемент управления list-view имеет LVS_EX_SUBITEMIMAGES расширенный стиль. В предыдущих версиях образ подэлемента будет игнорироваться.

Требования

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