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

Статья
10/24/2024

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

Синтаксис

int ListView_InsertItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

Параметры

hwnd

Тип: HWND

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

pitem

Тип: const LPLVITEM

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

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

Тип: int

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

Замечания

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

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

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

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	commctrl.h

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