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

  • Статья

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

Синтаксис

void ListView_SetItem(
   hwnd,
   pitem
);

Параметры

hwnd

Тип: HWND

Дескриптор элемента управления list-view.

pitem

Тип: const LPLVITEM

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

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

None

Remarks

Чтобы задать атрибуты элемента представления списка, задайте для элемента 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 [только классические приложения]
Целевая платформа Windows
Header commctrl.h