сообщение LVM_SETITEM

Статья
05/12/2022
Чтение занимает 2 мин

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

Параметры

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

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

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

Remarks

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

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

Требования

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