HDM_GETORDERARRAY Nachricht

Ruft die aktuelle Reihenfolge von Elementen von links nach rechts in einem Headersteuerelement ab. Sie können diese Nachricht explizit senden oder das Makro Header_GetOrderArray verwenden.

Parameter

wParam

Die Anzahl der ganzzahligen Elemente, die lParam enthalten kann. Dieser Wert muss gleich der Anzahl der Elemente im Steuerelement sein (siehe HDM_GETITEMCOUNT).

lParam

Ein Zeiger auf ein Array von ganzen Zahlen, die die Indexwerte für Elemente im Header empfangen.

Rückgabewert

Gibt bei erfolgreicher Ausführung ungleich null zurück, und der Puffer bei lParam empfängt die Elementnummer für jedes Element im Headersteuerelement in der Reihenfolge, in der sie von links nach rechts angezeigt werden. Andernfalls gibt die Nachricht null zurück.

Bemerkungen

Die Anzahl der Elemente in lParam wird in wParam angegeben und muss gleich der Anzahl der Elemente im Steuerelement sein. Beispielsweise reserviert das folgende Codefragment genügend Arbeitsspeicher, um die Indexwerte zu speichern.

int iItems,

    *lpiArray;



// Get memory for buffer.

(iItems = SendMessage(hwndHD, HDM_GETITEMCOUNT, 0,0))!=-1)

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

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h