_Сообщение LVM INSERTITEM

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

Параметры

wParam

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

lParam

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

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

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

Комментарии

Нельзя использовать ListView _ InsertItem или LVM _ InsertItem для вставки подэлементов. Элемент iSubItem структуры лвитем должен быть равен нулю. Сведения о настройке подэлементов см. в разделе LVM _ сетитем .

Если для элемента управления "представление списка" установлен стиль LVS _ ex _ , любое значение, помещенное в битах 12 – 15 элемента State структуры лвитем , будет игнорироваться. При добавлении элемента с этим набором стилей всегда будет задано непроверенное состояние.

Если элемент управления "представление списка" имеет стиль окна LVS _ Сортасцендинг или LVS _ сортдесцендинг , сообщение LVM _ INSERTITEM будет неудачным, если попытаться вставить элемент с LPSTR _ тексткаллбакк в качестве значения для его элемента псзтекст .

Сообщение LVM _ INSERTITEM будет вставлять новый элемент в надлежащей позиции в порядке сортировки, если выполняются следующие условия.

  • Вы используете один из _ стилей LVS сорткскскс.
  • Вы не используете стиль _ овнердрав LVS .
  • Элемент псзтекст структуры, на который указывает питем , не имеет значение LPSTR _ тексткаллбакк.

Если структура лвитем не содержит лвиф _ GROUPID в члене Mask , значение элемента играупид — I _ граупидкаллбакк по умолчанию.

Требования

Требование Значение
Минимальная версия клиента
Только для [ классических приложений Windows Vista]
Минимальная версия сервера
[Только для настольных приложений Windows Server 2003]
Header
Коммктрл. h
Имя в кодировке Юникод и ANSI
LVM _ ИНСЕРТИТЕМВ (Юникод) и LVM _ инсертитема (ANSI)