Teilen über

Kopfzeilensteuerelement

  • Artikel

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

Überblicke

Thema Inhalt
zu Kopfzeilensteuerelementen Ein Kopfzeilensteuerelement ist ein Fenster, das in der Regel über Text- oder Zahlenspalten positioniert ist. Er enthält einen Titel für jede Spalte und kann in Teile unterteilt werden.
Verwenden von Kopfzeilensteuerelementen Dieses Thema enthält Implementierungsdetails und Codebeispiele für Headersteuerelemente.

Macros

Thema Inhalt
Header_ClearAllFilters Löscht alle Filter für ein bestimmtes Kopfzeilensteuerelement. Sie können dieses Makro verwenden oder die HDM_CLEARFILTER Nachricht explizit senden.
Header_ClearFilter Löscht den Filter für ein bestimmtes Kopfzeilensteuerelement. Sie können dieses Makro verwenden oder die HDM_CLEARFILTER Nachricht explizit senden.
Header_CreateDragImage Erstellt eine transparente Version eines Elementbilds innerhalb eines vorhandenen Kopfzeilensteuerelements. Sie können dieses Makro verwenden oder die HDM_CREATEDRAGIMAGE Nachricht explizit senden.
Header_DeleteItem Löscht ein Element aus einem Kopfzeilensteuerelement. Sie können dieses Makro verwenden oder die HDM_DELETEITEM Nachricht explizit senden.
Header_EditFilter Verschiebt den Eingabefokus auf das Bearbeitungsfeld, wenn eine Filterschaltfläche den Fokus hat.
Header_GetBitmapMargin Ruft die Breite des Rands (in Pixel) einer Bitmap in einem vorhandenen Kopfzeilensteuerelement ab. Sie können dieses Makro verwenden oder die HDM_GETBITMAPMARGIN Nachricht explizit senden.
Header_GetFocusedItem Ruft das Element in einem Kopfzeilensteuerelement 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 Kopfzeilensteuerelement festgelegt wurde. Sie können dieses Makro verwenden oder die HDM_GETIMAGELIST Nachricht explizit senden.
Header_GetItem Ruft Informationen zu einem Element in einem Kopfzeilensteuerelement ab. Sie können dieses Makro verwenden oder die HDM_GETITEM Nachricht explizit senden.
Header_GetItemCount Ruft die Anzahl der Elemente in einem Kopfzeilensteuerelement 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 Kopfzeilensteuerelement ab. Das Kopfzeilensteuerelement 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 Kopfzeilensteuerelement ab. Sie können dieses Makro verwenden oder die HDM_GETITEMRECT Nachricht explizit senden.
Header_GetOrderArray 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.
Header_GetOverflowRect Ruft die Koordinaten des Dropdownüberlaufbereichs für ein angegebenes Kopfzeilensteuerelement ab. Das Kopfzeilensteuerelement 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 Header-Steuerelementstatus festgelegt wurde.
Header_GetUnicodeFormat Ruft das Unicode-Zeichenformat-Flag 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 Kopfzeilensteuerelement ein. Sie können dieses Makro verwenden oder die HDM_INSERTITEM Nachricht explizit senden.
Header_Layout Ruft die richtige Größe und Position eines Kopfzeilensteuerelements innerhalb des übergeordneten Fensters 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 Kopfzeilensteuerelement 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 Kopfzeilensteuerelement 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 und der Veröffentlichung einer HDN_FILTERCHANGE Benachrichtigung erfolgt. Sie können dieses Makro verwenden oder die HDM_SETFILTERCHANGETIMEOUT Nachricht explizit senden.
Header_SetFocusedItem Legt den Fokus auf ein angegebenes Element in einem Kopfzeilensteuerelement fest. Verwenden Sie dieses Makro, oder senden Sie die HDM_SETFOCUSEDITEM Nachricht explizit.
Header_SetHotDivider Ändert die Farbe einer Trennlinie 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 Kopfzeilensteuerelement 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 Kopfzeilensteuerelement 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 einer vorhandenen Kopfzeilensteuerelementliste eine Bildliste zu.
Header_SetUnicodeFormat Legt das UNICODE-Zeichenformat-Flag für das Steuerelement fest. Mit dieser Meldung können Sie den zeichensatz ändern, der vom Steuerelement zur Laufzeit verwendet wird, anstatt das Steuerelement erneut erstellen zu müssen. Sie können dieses Makro verwenden oder die HDM_SETUNICODEFORMAT Nachricht explizit senden.

Meldungen

Thema Inhalt
HDM_CLEARFILTER Löscht den Filter für ein bestimmtes Kopfzeilensteuerelement. Sie können diese Nachricht explizit senden oder das makro Header_ClearFilter verwenden.
HDM_CREATEDRAGIMAGE Erstellt eine halbtransparente Version des Bilds eines Elements für die Verwendung als Ziehbild. Sie können diese Nachricht explizit senden oder das Header_CreateDragImage Makro verwenden.
HDM_DELETEITEM Löscht ein Element aus einem Kopfzeilensteuerelement. Sie können diese Nachricht explizit senden oder das Header_DeleteItem Makro verwenden.
HDM_EDITFILTER Verschiebt den Eingabefokus auf das Bearbeitungsfeld, wenn eine Filterschaltfläche den Fokus hat.
HDM_GETBITMAPMARGIN Ruft die Breite des Bitmaprands für ein Kopfzeilensteuerelement ab. Sie können diese Nachricht explizit senden oder das Header_GetBitmapMargin Makro verwenden.
HDM_GETFOCUSEDITEM Ruft das Element in einem Kopfzeilensteuerelement ab, das den Fokus hat. Senden Sie diese Nachricht explizit oder mithilfe des Header_GetFocusedItem Makros. Ein Fenster empfängt diese Nachricht über die WindowProc--Funktion.
HDM_GETIMAGELIST Ruft das Handle für die Bildliste ab, die für ein vorhandenes Kopfzeilensteuerelement 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 Kopfzeilensteuerelement ab. Sie können diese Nachricht explizit senden oder das Header_GetItem Makro verwenden.
HDM_GETITEMCOUNT Ruft die Anzahl der Elemente in einem Kopfzeilensteuerelement ab. Sie können diese Nachricht explizit senden oder das Header_GetItemCount Makro verwenden.
HDM_GETITEMDROPDOWNRECT Ruft das umgebende Rechteck der geteilten Schaltfläche für ein Kopfzeilenelement mit Formatvorlage HDF_SPLITBUTTON ab. Senden Sie diese Nachricht explizit oder mithilfe desHeader_GetItemDropDownRectMakros.
HDM_GETITEMRECT Ruft das umgebende Rechteck für ein bestimmtes Element in einem Kopfzeilensteuerelement ab. Sie können diese Nachricht explizit senden oder das Header_GetItemRect Makro verwenden.
HDM_GETORDERARRAY Ruft die aktuelle Reihenfolge von Elementen in einem Kopfzeilensteuerelement von links nach rechts ab. Sie können diese Nachricht explizit senden oder das Header_GetOrderArray Makro verwenden.
HDM_GETOVERFLOWRECT Ruft das umgebende Rechteck der Überlaufschaltfläche ab, wenn die HDS_OVERFLOW Formatvorlage für das Kopfzeilensteuerelement festgelegt wird und die Überlaufschaltfläche sichtbar ist. Senden Sie diese Nachricht explizit oder mithilfe desHeader_GetOverflowRectMakros.
HDM_GETUNICODEFORMAT Ruft das Unicode-Zeichenformat-Flag für das Steuerelement ab. Sie können diese Nachricht explizit senden oder das Header_GetUnicodeFormat Makro verwenden.
HDM_HITTEST Testet einen Punkt, um zu bestimmen, welches Kopfzeilenelement (falls vorhanden) an dem angegebenen Punkt liegt.
HDM_INSERTITEM Fügt ein neues Element in ein Kopfzeilensteuerelement ein. Sie können diese Nachricht explizit senden oder das Header_InsertItem Makro verwenden.
HDM_LAYOUT Ruft Informationen ab, die zum Festlegen der Größe und Position des Kopfzeilensteuerelements innerhalb des Zielrechtecks des übergeordneten Fensters verwendet werden. Sie können diese Nachricht explizit senden oder das Header_Layout-Makro verwenden.
HDM_ORDERTOINDEX Ruft einen Indexwert für ein Element basierend auf seiner Reihenfolge im Kopfzeilensteuerelement ab. Sie können diese Nachricht explizit senden oder das Header_OrderToIndex Makro verwenden.
HDM_SETBITMAPMARGIN Legt die Breite des In Pixel angegebenen Rands einer Bitmap in einem vorhandenen Kopfzeilensteuerelement fest. Sie können diese Nachricht explizit senden oder das Header_SetBitmapMargin Makro verwenden.
HDM_SETFILTERCHANGETIMEOUT Legt das Timeoutintervall zwischen dem Zeitpunkt fest, zu dem eine Änderung in den Filterattributen und der Veröffentlichung einer HDN_FILTERCHANGE-Benachrichtigung erfolgt. Sie können diese Nachricht explizit senden oder das Header_SetFilterChangeTimeout Makro verwenden.
HDM_SETFOCUSEDITEM Legt den Fokus auf ein angegebenes Element in einem Kopfzeilensteuerelement fest. Senden Sie diese Nachricht explizit oder mithilfe des Header_SetFocusedItem Makros.
HDM_SETHOTDIVIDER Ändert die Farbe einer Trennlinie zwischen Kopfzeilenelementen, um das Ziel eines externen Drag-and-Drop-Vorgangs anzugeben. Sie können diese Nachricht explizit senden oder das Header_SetHotDivider Makro verwenden.
HDM_SETIMAGELIST Weist einem vorhandenen Kopfzeilensteuerelement 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 Kopfzeilensteuerelement fest. Sie können diese Nachricht explizit senden oder das Header_SetItem Makro verwenden.
HDM_SETORDERARRAY Legt die Reihenfolge von Kopfzeilenelementen von links nach rechts fest. Sie können diese Nachricht explizit senden oder das Header_SetOrderArray Makro verwenden.
HDM_SETUNICODEFORMAT Legt das UNICODE-Zeichenformat-Flag für das Steuerelement fest. Mit dieser Meldung können Sie den zeichensatz ändern, der vom Steuerelement zur Laufzeit verwendet wird, anstatt das Steuerelement erneut erstellen zu müssen. Sie können diese Nachricht explizit senden oder das Header_SetUnicodeFormat Makro verwenden.
HDM_TRANSLATEACCELERATOR Nicht implementiert.

Benachrichtigungen

Thema Inhalt
HDN_BEGINDRAG Gesendet von einem Kopfzeilensteuerelement, wenn ein Ziehvorgang für eines der Elemente begonnen hat. Dieser Benachrichtigungscode wird nur von Kopfzeilensteuerelementen gesendet, die auf die HDS_DRAGDROP Formatvorlage festgelegt sind. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_BEGINFILTEREDIT Benachrichtigt das übergeordnete Fenster eines Kopfzeilensteuerelements, 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 mit dem Ziehen einer Trennlinie im Steuerelement begonnen hat (d. r. der Benutzer hat die linke Maustaste gedrückt, während sich der Mauszeiger auf einer Trennlinie im Kopfzeilensteuerelement befindet). Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_DIVIDERDBLCLICK Benachrichtigt das übergeordnete Fenster eines Kopfzeilensteuerelements, 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 Kopfzeilensteuerelement an das übergeordnete Steuerelement gesendet, wenn auf den Dropdownpfeil des Kopfzeilensteuerelements geklickt wird. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_ENDDRAG Wird von einem Kopfzeilensteuerelement gesendet, wenn ein Ziehvorgang auf einem der zugehörigen Elemente beendet wurde. Dieser Benachrichtigungscode wird als WM_NOTIFY Nachricht gesendet. Nur Kopfzeilensteuerelemente, die auf die HDS_DRAGDROP Formatvorlage festgelegt sind, senden diese Benachrichtigung.
HDN_ENDFILTEREDIT Benachrichtigt das übergeordnete Fenster eines Kopfzeilensteuerelements, dass eine Filterbearbeitung beendet wurde. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_ENDTRACK Benachrichtigt das übergeordnete Fenster eines Kopfzeilensteuerelements, dass der Benutzer das Ziehen einer Trennlinie abgeschlossen hat. Dieser Benachrichtigungscode, der in Form einer WM_NOTIFY Nachricht gesendet wurde.
HDN_FILTERBTNCLICK Benachrichtigt das übergeordnete Fenster des Kopfzeilensteuerelements, wenn auf die Filterschaltfläche geklickt oder als Reaktion auf eine HDM_SETITEM Nachricht geklickt wird.
HDN_FILTERCHANGE Benachrichtigt das übergeordnete Fenster des Kopfzeilensteuerelements, dass die Attribute eines Headersteuerelementfilters geändert oder bearbeitet werden.
HDN_GETDISPINFO Wird an den Besitzer eines Kopfzeilensteuerelements gesendet, wenn das Steuerelement Informationen zu einem Rückrufkopfelement benötigt. Dieser Benachrichtigungscode wird als WM_NOTIFY Nachricht gesendet.
HDN_ITEMCHANGED Benachrichtigt das übergeordnete Fenster eines Kopfzeilensteuerelements, 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 Kopfzeilensteuerelements, dass sich die Attribute eines Kopfzeilenelements ändern. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_ITEMCLICK Benachrichtigt das übergeordnete Fenster eines Kopfzeilensteuerelements, 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 Kopfzeilensteuerelemente, die auf die HDS_BUTTONS Formatvorlage festgelegt sind, senden diese Benachrichtigung.
HDN_ITEMKEYDOWN Benachrichtigt das übergeordnete Fenster eines Kopfzeilensteuerelements, dass eine Taste mit einem ausgewählten Element gedrückt wurde. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
HDN_ITEMSTATEICONCLICK Benachrichtigt das übergeordnete Fenster eines Kopfzeilensteuerelements, dass der Benutzer auf das Statussymbol eines Elements geklickt hat.
HDN_OVERFLOWCLICK Wird von einem Kopfzeilensteuerelement an das übergeordnete Steuerelement 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 Kopfzeilensteuerelements, dass der Benutzer eine Trennlinie im Kopfzeilensteuerelement zieht. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_CUSTOMDRAW (Kopfzeile) Gesendet von einem Kopfzeilensteuerelement, um das übergeordnete Fenster über Zeichnungsvorgänge zu benachrichtigen. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_RCLICK (Kopfzeile) Benachrichtigt das übergeordnete Fenster eines Strukturansicht-Steuerelements, dass der Benutzer auf die rechte Maustaste im Steuerelement geklickt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_RELEASEDCAPTURE (Kopfzeile) Benachrichtigt das übergeordnete Fenster eines Kopfzeilensteuerelements, dass das Steuerelement die Mausaufnahme loslässt. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.

Konstanten

Thema Inhalt
Formatvorlagen für Kopfzeilensteuerelemente Kopfzeilensteuerelemente weisen eine Reihe von Formatvorlagen auf, die in diesem Abschnitt beschrieben werden, die das Aussehen und Verhalten des Steuerelements bestimmen. Beim Erstellen des Kopfzeilensteuerelements legen Sie die ursprünglichen Formatvorlagen fest.