сообщение LVM_SETITEM
Задает некоторые или все атрибуты элемента представления списка. Вы также можете отправить 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 [только классические приложения] |
Заголовок |
|
Имя в кодировке Юникод и ANSI |
LVM_SETITEMW (Юникод) и LVM_SETITEMA (ANSI) |