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

Статья
10/24/2024

Получает сведения об элементе в элементе управления заголовком. Этот макрос можно использовать или явно отправить сообщение HDM_GETITEM.

Синтаксис

BOOL Header_GetItem(
   HWND     hwndHD,
   int      i,
   LPHDITEM phdi
);

Параметры

hwndHD

Тип: HWND

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

i

Тип: int

Индекс элемента, для которого требуется получить сведения.

phdi

Тип: LPHDITEM

Указатель на структуру HDITEM . При отправке сообщения маска указывает тип запрашиваемой информации. Когда сообщение возвращается, другие участники получают запрошенные сведения. Если элемент маски указывает ноль, сообщение возвращает TRUE, но не копирует сведения в структуру.

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

Тип: BOOL

Возвращает TRUE, если выполнено успешно или FALSE в противном случае.

Замечания

Если флаг HDI_TEXT задан в элементе маски элемента структуры HDITE M, элемент управления может изменить элемент управления pszText, чтобы он указывал на новый текст, а не заполнять буфер запрошенным текстом. Приложения не должны предполагать, что текст всегда помещается в запрошенный буфер.

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

#define Header_GetItem(hwndHD, i, phdi)      \

    (BOOL)SendMessage((hwndHD), HDM_GETITEM,   \

    (WPARAM)(int)(i), (LPARAM)(LPHDITEM)(phdi))

Требования

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

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