LVM_INSERTITEM сообщение

  • Статья

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

Параметры

wParam

Должен равняться нулю.

lParam

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

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

Возвращает индекс нового элемента в случае успешного выполнения или значение -1 в противном случае.

Комментарии

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

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

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

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

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

Если структура LVITEM не содержит LVIF_GROUPID в элементе маски , значение элемента iGroupId по умолчанию I_GROUPIDCALLBACK.

Требования

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