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

  • Статья

Вставляет новый элемент в элемент управления "Представление списка". Вы можете использовать этот макрос или отправить сообщение LVM_INSERTITEM явным образом.

Синтаксис

void ListView_InsertItem(
   hwnd,
   pitem
);

Параметры

hwnd

Тип: HWND

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

pitem

Тип: const LPLVITEM

Указатель на структуру LVITEM , которая задает атрибуты элемента представления списка. Используйте элемент iItem , чтобы указать отсчитываемый от нуля индекс, по которому должен быть вставлен новый элемент. Если это значение превышает количество элементов, содержащихся в данный момент в элементе управления listview, новый элемент будет добавлен в конец списка и назначен правильный индекс. Проверьте возвращаемое значение макроса, чтобы определить фактический индекс, назначенный элементу.

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

None

Remarks

Для вставки подэлементов нельзя использовать ListView_InsertItem или LVM_INSERTITEM . Элемент iSubItem структуры LVITEM должен быть равен нулю. Дополнительные сведения о настройке подэлементов см. в разделе LVM_SETITEM .

Если для элемента управления представлением списка задан стиль LVS_EX_CHECKBOXES , любое значение, помещенное в биты от 12 до 15 элемента состояния структуры LVITEM , будет игнорироваться. При добавлении элемента с этим набором стилей ему всегда будет присвоено состояние без флажка.

Если элемент управления представлением списка имеет стиль окна LVS_SORTASCENDING или LVS_SORTDESCENDING, при попытке вставить элемент, LPSTR_TEXTCALLBACK в качестве элемента pszText его структуры LVITEM, сообщение LVM_INSERTITEM завершится ошибкой.

Макрос ListView_InsertItem вставляет новый элемент в правильное положение в порядке сортировки, если хранятся следующие условия:

  • Вы используете один из стилей LVS_SORTXXX.
  • Вы не используете стиль LVS_OWNERDRAW.
  • Элемент pszText структуры, на которую указывает pitem , не имеет значения LPSTR_TEXTCALLBACK.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header commctrl.h