macro Header_GetOrderArray (commctrl.h)

Obtiene el orden de izquierda a derecha actual de los elementos de un control de encabezado. Puede usar esta macro o enviar el mensaje HDM_GETORDERARRAY explícitamente.

Sintaxis

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

Parámetros

hwnd

Tipo: HWND

Identificador de un control de encabezado.

iCount

Tipo: int

Número de elementos enteros que lpiArray. Este valor debe ser igual al número de elementos del control (vea HDM_GETITEMCOUNT).

lpi

Tipo: int*

Puntero a una matriz de enteros que reciben los valores de índice de los elementos del encabezado.

Valor devuelto

Tipo: BOOL de

Devuelve un valor distinto de cero si se ejecuta correctamente y el búfer de lpiArray recibe el número de elemento de cada elemento del control de encabezado en el orden en que aparecen de izquierda a derecha. Devuelve cero de lo contrario.

Observaciones

El número de elementos de lpiArray se especifica en iCount y debe ser igual al número de elementos del control. Por ejemplo, el fragmento de código siguiente reservará suficiente memoria para contener los 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
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	commctrl.h