Header_GetOrderArray Makro (commctrl.h)

Artikel
10/24/2024

Ruft die aktuelle Reihenfolge von Elementen in einem Kopfzeilensteuerelement von links nach rechts ab. Sie können dieses Makro verwenden oder die HDM_GETORDERARRAY Nachricht explizit senden.

Syntax

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

Parameter

hwnd

Typ: HWND-

Ein Handle für ein Kopfzeilensteuerelement.

iCount

Typ: int

Die Anzahl der ganzzahligen Elemente, die lpiArray- enthalten können. Dieser Wert muss der Anzahl der Elemente im Steuerelement entsprechen (siehe HDM_GETITEMCOUNT).

lpi

Typ: int*

Ein Zeiger auf ein Array mit ganzen Zahlen, die die Indexwerte für Elemente in der Kopfzeile empfangen.

Rückgabewert

Typ: BOOL-

Gibt bei erfolgreicher Ausführung ein Nonzero zurück, und der Puffer bei lpiArray erhält die Elementnummer der einzelnen Elemente im Kopfzeilensteuerelement in der Reihenfolge, in der sie von links nach rechts angezeigt werden. Gibt andernfalls Null zurück.

Bemerkungen

Die Anzahl der Elemente in lpiArray- wird in iCount- angegeben und muss der Anzahl der Elemente im Steuerelement entsprechen. Das folgende Codefragment reserviert z. B. genügend Arbeitsspeicher, um die Indexwerte zu speichern.


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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h

Freigeben über