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

Статья
10/24/2024

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

Синтаксис

int Header_InsertItem(
         HWND     hwndHD,
         int      i,
   const LPHDITEM phdi
);

Параметры

hwndHD

Тип: HWND

Дескриптор элемента управления заголовком.

i

Тип: int

Индекс элемента, после которого нужно вставить новый элемент. Новый элемент вставляется в конце элемента управления заголовком, если i больше или равно числу элементов в элементе управления. Если i равно нулю, новый элемент вставляется в начале элемента управления заголовком.

phdi

Тип: const LPHDITEM

Указатель на структуру HDITEM, содержащую сведения о новом элементе.

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

Тип: int

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

Замечания

Макрос Header_InsertItem определяется следующим образом:

#define Header_InsertItem(hwndHD, i, phdi) \

    (int)SendMessage((hwndHD), HDM_INSERTITEM, (WPARAM)(int)(i), \

    (LPARAM)(const LPHDITEM)(phdi))

Требования

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

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