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