макрос ListView_SetItem (commctrl.h)

Статья
10/24/2024

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

Синтаксис

BOOL ListView_SetItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

Параметры

hwnd

Тип: HWND

Дескриптор элемента управления "Представление списка".

pitem

Тип: const LPLVITEM

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

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

Тип: BOOL

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

Замечания

Чтобы задать атрибуты элемента представления списка, задайте для элемента 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

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