macro Header_GetOrderArray (commctrl.h)

Articolo
10/24/2024

Ottiene l'ordine corrente da sinistra a destra degli elementi in un controllo intestazione. È possibile utilizzare questa macro o inviare il messaggio di HDM_GETORDERARRAY in modo esplicito.

Sintassi

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

Parametri

hwnd

Tipo: HWND

Handle di un controllo di intestazione.

iCount

Tipo: int

Numero di elementi integer che lpiArray. Questo valore deve essere uguale al numero di elementi nel controllo (vedere HDM_GETITEMCOUNT).

lpi

Tipo: int*

Puntatore a una matrice di numeri interi che ricevono i valori di indice per gli elementi nell'intestazione.

Valore restituito

Tipo: BOOL

Restituisce un valore diverso da zero se ha esito positivo e il buffer in corrispondenza di lpiArray riceve il numero di elemento di ogni elemento nel controllo intestazione nell'ordine in cui vengono visualizzati da sinistra a destra. Restituisce zero in caso contrario.

Osservazioni

Il numero di elementi in lpiArray viene specificato in iCount e deve essere uguale al numero di elementi nel controllo . Ad esempio, il frammento di codice seguente riserva memoria sufficiente per contenere i valori di indice.


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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h

Condividi tramite