Header_GetOrderArray macro (commctrl.h)

Artigo
10/24/2024

Obtém a ordem atual da esquerda para a direita dos itens em um controle de cabeçalho. Você pode usar essa macro ou enviar a mensagem HDM_GETORDERARRAY explicitamente.

Sintaxe

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

Parâmetros

hwnd

Tipo: HWND

Um identificador para um controle de cabeçalho.

iCount

Tipo: int

O número de elementos inteiros que lpiArray pode conter. Esse valor deve ser igual ao número de itens no controle (consulte HDM_GETITEMCOUNT).

lpi

Tipo: int*

Um ponteiro para uma matriz de inteiros que recebem os valores de índice para itens no cabeçalho.

Valor de retorno

Tipo: BOOL

Retorna diferente de zero se bem-sucedido, e o buffer em lpiArray recebe o número de item de cada item no controle de cabeçalho na ordem em que eles aparecem da esquerda para a direita. Retorna zero caso contrário.

Observações

O número de elementos em lpiArray é especificado em iCount e deve ser igual ao número de itens no controle. Por exemplo, o fragmento de código a seguir reservará memória suficiente para manter os valores de índice.


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);

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via