Headersteuerelement

Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit Headersteuerelementen verwendet werden.

Übersichten

Thema	Inhalte
Informationen zu Headersteuerelementen	Ein Headersteuerelement ist ein Fenster, das sich normalerweise über Text- oder Zahlenspalten befindet. Sie enthält einen Titel für jede Spalte und kann in Teile unterteilt werden.
Verwenden von Headersteuerelementen	In diesem Thema finden Sie Implementierungsdetails und Codebeispiele für Headersteuerelemente.

Makros

Thema	Inhalte
Header_ClearAllFilters	Löscht alle Filter für ein bestimmtes Headersteuerelement. Sie können dieses Makro verwenden oder die HDM_CLEARFILTER Nachricht explizit senden.
Header_ClearFilter	Löscht den Filter für ein bestimmtes Headersteuerelement. Sie können dieses Makro verwenden oder die HDM_CLEARFILTER Nachricht explizit senden.
Header_CreateDragImage	Erstellt eine transparente Version eines Elementimages in einem vorhandenen Headersteuerelement. Sie können dieses Makro verwenden oder die HDM_CREATEDRAGIMAGE Nachricht explizit senden.
Header_DeleteItem	Löscht ein Element aus einem Headersteuerelement. Sie können dieses Makro verwenden oder die HDM_DELETEITEM Nachricht explizit senden.
Header_EditFilter	Verschiebt den Eingabefokus in das Bearbeitungsfeld, wenn eine Filterschaltfläche den Fokus hat.
Header_GetBitmapMargin	Ruft die Breite des Rands (in Pixel) einer Bitmap in einem vorhandenen Headersteuerelement ab. Sie können dieses Makro verwenden oder die HDM_GETBITMAPMARGIN Nachricht explizit senden.
Header_GetFocusedItem	Ruft das Element in einem Headersteuerelement ab, das den Fokus hat. Verwenden Sie dieses Makro, oder senden Sie die HDM_GETFOCUSEDITEM Nachricht explizit.
Header_GetImageList	Ruft das Handle für die Bildliste ab, die für ein vorhandenes Headersteuerelement festgelegt wurde. Sie können dieses Makro verwenden oder die HDM_GETIMAGELIST Nachricht explizit senden.
Header_GetItem	Ruft Informationen zu einem Element in einem Headersteuerelement ab. Sie können dieses Makro verwenden oder die HDM_GETITEM Nachricht explizit senden.
Header_GetItemCount	Ruft eine Anzahl der Elemente in einem Headersteuerelement ab. Sie können dieses Makro verwenden oder die HDM_GETITEMCOUNT Nachricht explizit senden.
Header_GetItemDropDownRect	Ruft die Koordinaten der Dropdownschaltfläche für ein angegebenes Element in einem Headersteuerelement ab. Das Headersteuerelement muss vom Typ HDF_SPLITBUTTON sein. Verwenden Sie dieses Makro, oder senden Sie die HDM_GETITEMDROPDOWNRECT Nachricht explizit.
Header_GetItemRect	Ruft das umgebende Rechteck für ein bestimmtes Element in einem Headersteuerelement ab. Sie können dieses Makro verwenden oder die HDM_GETITEMRECT Nachricht explizit senden.
Header_GetOrderArray	Ruft die aktuelle Links-rechts-Reihenfolge von Elementen in einem Headersteuerelement ab. Sie können dieses Makro verwenden oder die HDM_GETORDERARRAY Nachricht explizit senden.
Header_GetOverflowRect	Ruft die Koordinaten des Dropdownüberlaufbereichs für ein angegebenes Headersteuerelement ab. Das Headersteuerelement muss vom Typ HDF_SPLITBUTTON sein. Verwenden Sie dieses Makro, oder senden Sie die HDM_GETOVERFLOWRECT Nachricht explizit.
Header_GetStateImageList	Ruft das Handle für die Bildliste ab, die für einen vorhandenen Headersteuerelementstatus festgelegt wurde.
Header_GetUnicodeFormat	Ruft das Unicode-Zeichenformatflag für das Steuerelement ab. Sie können dieses Makro verwenden oder die HDM_GETUNICODEFORMAT Nachricht explizit senden.
Header_InsertItem	Fügt ein neues Element in ein Headersteuerelement ein. Sie können dieses Makro verwenden oder die HDM_INSERTITEM Nachricht explizit senden.
Header_Layout	Ruft die richtige Größe und Position eines Headersteuerelements im übergeordneten Fenster ab. Sie können dieses Makro verwenden oder die HDM_LAYOUT-Nachricht explizit senden.
Header_OrderToIndex	Ruft einen Indexwert für ein Element basierend auf seiner Reihenfolge im Headersteuerelement ab. Sie können dieses Makro verwenden oder die HDM_ORDERTOINDEX Nachricht explizit senden.
Header_SetBitmapMargin	Legt die Breite des Rands für eine Bitmap in einem vorhandenen Headersteuerelement fest. Sie können dieses Makro verwenden oder die HDM_SETBITMAPMARGIN Nachricht explizit senden.
Header_SetFilterChangeTimeout	Legt das Timeoutintervall zwischen dem Zeitpunkt fest, zu dem eine Änderung in den Filterattributen erfolgt, und der Veröffentlichung einer HDN_FILTERCHANGE Benachrichtigung. Sie können dieses Makro verwenden oder die HDM_SETFILTERCHANGETIMEOUT Nachricht explizit senden.
Header_SetFocusedItem	Legt den Fokus auf ein angegebenes Element in einem Headersteuerelement fest. Verwenden Sie dieses Makro, oder senden Sie die HDM_SETFOCUSEDITEM Nachricht explizit.
Header_SetHotDivider	Ändert die Farbe eines Trenners zwischen Kopfzeilenelementen, um das Ziel eines externen Drag-and-Drop-Vorgangs anzugeben. Sie können dieses Makro verwenden oder die HDM_SETHOTDIVIDER Nachricht explizit senden.
Header_SetImageList	Weist einem vorhandenen Headersteuerelement eine Bildliste zu. Sie können dieses Makro verwenden oder die HDM_SETIMAGELIST Nachricht explizit senden.
Header_SetItem	Legt die Attribute des angegebenen Elements in einem Headersteuerelement fest. Sie können dieses Makro verwenden oder die HDM_SETITEM Nachricht explizit senden.
Header_SetOrderArray	Legt die Reihenfolge von Kopfzeilenelementen von links nach rechts fest. Sie können dieses Makro verwenden oder die HDM_SETORDERARRAY Nachricht explizit senden.
Header_SetStateImageList	Weist eine Bildliste einem vorhandenen Headersteuerelementstatus zu.
Header_SetUnicodeFormat	Legt das UNICODE-Zeichenformatflag für das Steuerelement fest. Mit dieser Meldung können Sie den vom Steuerelement verwendeten Zeichensatz zur Laufzeit ändern, anstatt das Steuerelement neu erstellen zu müssen. Sie können dieses Makro verwenden oder die HDM_SETUNICODEFORMAT Nachricht explizit senden.

Nachrichten

Thema	Inhalte
HDM_CLEARFILTER	Löscht den Filter für ein bestimmtes Headersteuerelement. Sie können diese Nachricht explizit senden oder das makro Header_ClearFilter verwenden.
HDM_CREATEDRAGIMAGE	Erstellt eine halbtransparente Version des Bilds eines Elements zur Verwendung als Ziehen eines Bilds. Sie können diese Nachricht explizit senden oder das makro Header_CreateDragImage verwenden.
HDM_DELETEITEM	Löscht ein Element aus einem Headersteuerelement. Sie können diese Nachricht explizit senden oder das makro Header_DeleteItem verwenden.
HDM_EDITFILTER	Verschiebt den Eingabefokus in das Bearbeitungsfeld, wenn eine Filterschaltfläche den Fokus hat.
HDM_GETBITMAPMARGIN	Ruft die Breite des Bitmaprands für ein Headersteuerelement ab. Sie können diese Nachricht explizit senden oder das makro Header_GetBitmapMargin verwenden.
HDM_GETFOCUSEDITEM	Ruft das Element in einem Headersteuerelement ab, das den Fokus hat. Senden Sie diese Nachricht explizit oder mithilfe des makros Header_GetFocusedItem . Ein Fenster empfängt diese Nachricht über seine WindowProc-Funktion .
HDM_GETIMAGELIST	Ruft das Handle für die Bildliste ab, die für ein vorhandenes Headersteuerelement festgelegt wurde. Sie können diese Nachricht explizit senden oder das makro Header_GetImageList oder Header_GetStateImageList verwenden.
HDM_GETITEM	Ruft Informationen zu einem Element in einem Headersteuerelement ab. Sie können diese Nachricht explizit senden oder das makro Header_GetItem verwenden.
HDM_GETITEMCOUNT	Ruft eine Anzahl der Elemente in einem Headersteuerelement ab. Sie können diese Nachricht explizit senden oder das makro Header_GetItemCount verwenden.
HDM_GETITEMDROPDOWNRECT	Ruft das umschließende Rechteck der geteilten Schaltfläche für ein Kopfzeilenelement mit HDF_SPLITBUTTON ab. Senden Sie diese Nachricht explizit oder mithilfe desmakros Header_GetItemDropDownRect.
HDM_GETITEMRECT	Ruft das umgebende Rechteck für ein bestimmtes Element in einem Headersteuerelement ab. Sie können diese Nachricht explizit senden oder das makro Header_GetItemRect verwenden.
HDM_GETORDERARRAY	Ruft die aktuelle Links-rechts-Reihenfolge von Elementen in einem Headersteuerelement ab. Sie können diese Nachricht explizit senden oder das makro Header_GetOrderArray verwenden.
HDM_GETOVERFLOWRECT	Ruft das umgebende Rechteck der Überlaufschaltfläche ab, wenn die HDS_OVERFLOW-Formatvorlage für das Headersteuerelement festgelegt ist und die Überlaufschaltfläche sichtbar ist. Senden Sie diese Nachricht explizit oder mithilfe desmakros Header_GetOverflowRect.
HDM_GETUNICODEFORMAT	Ruft das Unicode-Zeichenformatflag für das Steuerelement ab. Sie können diese Nachricht explizit senden oder das makro Header_GetUnicodeFormat verwenden.
HDM_HITTEST	Testet einen Punkt, um zu bestimmen, welches Headerelement sich (falls vorhanden) an dem angegebenen Punkt befindet.
HDM_INSERTITEM	Fügt ein neues Element in ein Headersteuerelement ein. Sie können diese Nachricht explizit senden oder das makro Header_InsertItem verwenden.
HDM_LAYOUT	Ruft Informationen ab, die zum Festlegen der Größe und Position des Headersteuerelements im Zielrechteck des übergeordneten Fensters verwendet werden. Sie können diese Nachricht explizit senden oder das makro Header_Layout verwenden.
HDM_ORDERTOINDEX	Ruft einen Indexwert für ein Element basierend auf seiner Reihenfolge im Headersteuerelement ab. Sie können diese Nachricht explizit senden oder das makro Header_OrderToIndex verwenden.
HDM_SETBITMAPMARGIN	Legt die Breite des in Pixel angegebenen Rands einer Bitmap in einem vorhandenen Headersteuerelement fest. Sie können diese Nachricht explizit senden oder das makro Header_SetBitmapMargin verwenden.
HDM_SETFILTERCHANGETIMEOUT	Legt das Timeoutintervall zwischen dem Zeitpunkt fest, zu dem eine Änderung in den Filterattributen erfolgt, und der Veröffentlichung einer HDN_FILTERCHANGE Benachrichtigung. Sie können diese Nachricht explizit senden oder das makro Header_SetFilterChangeTimeout verwenden.
HDM_SETFOCUSEDITEM	Legt den Fokus auf ein angegebenes Element in einem Headersteuerelement fest. Senden Sie diese Nachricht explizit oder mithilfe des makros Header_SetFocusedItem .
HDM_SETHOTDIVIDER	Ändert die Farbe eines Trenners zwischen Kopfzeilenelementen, um das Ziel eines externen Drag-and-Drop-Vorgangs anzugeben. Sie können diese Nachricht explizit senden oder das makro Header_SetHotDivider verwenden.
HDM_SETIMAGELIST	Weist einem vorhandenen Headersteuerelement eine Bildliste zu. Sie können diese Nachricht explizit senden oder das makro Header_SetImageList oder Header_SetStateImageList verwenden.
HDM_SETITEM	Legt die Attribute des angegebenen Elements in einem Headersteuerelement fest. Sie können diese Nachricht explizit senden oder das makro Header_SetItem verwenden.
HDM_SETORDERARRAY	Legt die Reihenfolge von Kopfzeilenelementen von links nach rechts fest. Sie können diese Nachricht explizit senden oder das makro Header_SetOrderArray verwenden.
HDM_SETUNICODEFORMAT	Legt das UNICODE-Zeichenformatflag für das Steuerelement fest. Mit dieser Meldung können Sie den vom Steuerelement verwendeten Zeichensatz zur Laufzeit ändern, anstatt das Steuerelement neu erstellen zu müssen. Sie können diese Nachricht explizit senden oder das makro Header_SetUnicodeFormat verwenden.
HDM_TRANSLATEACCELERATOR	Nicht implementiert.

Benachrichtigungen

Thema	Inhalte
HDN_BEGINDRAG	Wird von einem Headersteuerelement gesendet, wenn ein Ziehvorgang für eines seiner Elemente begonnen hat. Dieser Benachrichtigungscode wird nur von Headersteuerelementen gesendet, die auf die HDS_DRAGDROP-Format festgelegt sind. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_BEGINFILTEREDIT	Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, dass eine Filterbearbeitung begonnen hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_BEGINTRACK	Benachrichtigt das übergeordnete Fenster eines Kopfzeilensteuerelements, dass der Benutzer begonnen hat, eine Trennlinie im Steuerelement zu ziehen (das heißt, der Benutzer hat die linke Maustaste gedrückt, während sich der Mauscursor auf einer Trennlinie im Headersteuerelement befindet). Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_DIVIDERDBLCLICK	Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, dass der Benutzer auf den Trennbereich des Steuerelements doppelklicken hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_DROPDOWN	Wird von einem Headersteuerelement an das übergeordnete Steuerelement gesendet, wenn auf den Dropdownpfeil für das Headersteuerelement geklickt wird. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_ENDDRAG	Wird von einem Headersteuerelement gesendet, wenn ein Ziehvorgang für eines seiner Elemente beendet wurde. Dieser Benachrichtigungscode wird als WM_NOTIFY Nachricht gesendet. Nur Headersteuerelemente, die auf die HDS_DRAGDROP-Format festgelegt sind, senden diese Benachrichtigung.
HDN_ENDFILTEREDIT	Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, dass eine Filterbearbeitung beendet wurde. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_ENDTRACK	Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, dass der Benutzer das Ziehen einer Trennlinie abgeschlossen hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_FILTERBTNCLICK	Benachrichtigt das übergeordnete Fenster des Headersteuerelements, wenn auf die Filterschaltfläche geklickt wird oder als Reaktion auf eine HDM_SETITEM Meldung.
HDN_FILTERCHANGE	Benachrichtigt das übergeordnete Fenster des Headersteuerelements, dass die Attribute eines Headersteuerelementfilters geändert oder bearbeitet werden.
HDN_GETDISPINFO	Wird an den Besitzer eines Headersteuerelements gesendet, wenn das Steuerelement Informationen zu einem Rückrufheaderelement benötigt. Dieser Benachrichtigungscode wird als WM_NOTIFY Nachricht gesendet.
HDN_ITEMCHANGED	Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, dass sich die Attribute eines Kopfzeilenelements geändert haben. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_ITEMCHANGING	Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, dass sich die Attribute eines Kopfzeilenelements ändern. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_ITEMCLICK	Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, dass der Benutzer auf das Steuerelement geklickt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_ITEMDBLCLICK	Benachrichtigt das übergeordnete Fenster eines Kopfzeilensteuerelements, dass der Benutzer auf das Steuerelement doppelklicken hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. Nur Headersteuerelemente, die auf die HDS_BUTTONS-Format festgelegt sind, senden diese Benachrichtigung.
HDN_ITEMKEYDOWN	Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, dass eine Taste gedrückt wurde, wobei ein Element ausgewählt ist. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_ITEMSTATEICONCLICK	Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, dass der Benutzer auf das Statussymbol eines Elements geklickt hat.
HDN_OVERFLOWCLICK	Wird von einem Headersteuerelement an sein übergeordnetes Element gesendet, wenn auf die Überlaufschaltfläche der Kopfzeile geklickt wird. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_TRACK	Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, dass der Benutzer eine Trennlinie in das Headersteuerelement zieht. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_CUSTOMDRAW (Header)	Wird von einem Headersteuerelement gesendet, um das übergeordnete Fenster über Zeichnungsvorgänge zu benachrichtigen. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_RCLICK (Header)	Benachrichtigt das übergeordnete Fenster eines Strukturansichtssteuerelements, dass der Benutzer auf die rechte Maustaste im Steuerelement geklickt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_RELEASEDCAPTURE (Header)	Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, dass das Steuerelement die Mausaufnahme freigibt. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.

Konstanten

Thema	Inhalte
Formatvorlagen für Headersteuerelemente	Headersteuerelemente verfügen über eine Reihe von Stilen, die in diesem Abschnitt beschrieben werden und das Aussehen und Verhalten des Steuerelements bestimmen. Sie legen die anfänglichen Stile fest, wenn Sie das Headersteuerelement erstellen.