Headersteuerelement

  • Artikel

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.