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

Статья
10/24/2024

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

Синтаксис

BOOL Header_GetOrderArray(
   HWND hwnd,
   int  iCount,
   int  *lpi
);

Параметры

hwnd

Тип: HWND

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

iCount

Тип: int

Количество целых элементов, которые могут содержать lpiArray. Это значение должно быть равно количеству элементов в элементе управления (см. HDM_GETITEMCOUNT).

lpi

Тип: int*

Указатель на массив целых чисел, получающих значения индекса для элементов в заголовке.

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

Тип: BOOL

Возвращает ненулевое значение в случае успешного выполнения, а буфер в lpiArray получает номер элемента в элементе управления заголовком в порядке, в котором они отображаются слева направо. Возвращает ноль в противном случае.

Замечания

Число элементов в lpiArray указывается в iCount и должно быть равно количеству элементов в элементе управления. Например, следующий фрагмент кода будет резервировать достаточно памяти для хранения значений индекса.


int iItems,

    *lpi;



// Get memory for buffer

if((iItems = SendMessage(hwnd, HDM_GETITEMCOUNT, 0,0))!=-1)

    if(!(lpiArray = calloc(iItems,sizeof(int))))

MessageBox(hwnd, "Out of memory.","Error", MB_OK);

Требования

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

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