Header-Steuerelement
Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit Headersteuerelementen verwendet werden.
Übersichten
| Thema | Inhalte |
|---|---|
| Informationen zu Headersteuerelementen | Ein Headersteuerfeld ist ein Fenster, das in der Regel über Spalten mit Text oder Zahlen positioniert ist. Sie enthält einen Titel für jede Spalte und kann in Teile unterteilt werden. |
| Verwenden von Headersteuerelementen | Dieses Thema enthält Implementierungsdetails und Codebeispiele für Headersteuerelemente. |
Makros
| Thema | Inhalte |
|---|---|
| Header _ ClearAllFilters | Hier werden alle Filter für ein bestimmtes Headersteuersatz-Steuerelement löschen. Sie können dieses Makro verwenden oder die HDM _ CLEARFILTER-Nachricht explizit senden. |
| Header _ ClearFilter | Clears the filter for a given header control. (Löschen des Filters für ein bestimmtes Headersteuer steuerelement.) Sie können dieses Makro verwenden oder die HDM _ CLEARFILTER-Nachricht explizit senden. |
| Header _ CreateDragImage | Erstellt eine transparente Version eines Elementimages innerhalb eines vorhandenen Headersteuerelements. Sie können dieses Makro verwenden oder die HDM _ CREATEDRAGIMAGE-Nachricht explizit senden. |
| _DeleteItem-Header | 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 besitzt. |
| Header _ GetBitmapMargin | Ruft die Breite des Rands (in Pixel) einer Bitmap in einem vorhandenen Header-Steuerelement 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 besitzt. 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 Header-Steuerelement 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 die Anzahl der Elemente in einem Headersteuerelementen 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 Headersteuerfeld muss vom Typ HDF _ SPLITBUTTON sein. Verwenden Sie dieses Makro, oder senden Sie die HDM _ GETITEMDROPDOWNRECT-Nachricht explizit. |
| Header _ GetItemRect | Ruft das umgebundene 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 Reihenfolge von links nach rechts von Elementen in einem Headersteuerelementen 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 Header-Steuerelement ab. Das Headersteuerfeld 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-Steuerelementzustand 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. |
| _InsertItem-Header | Fügt ein neues Element in ein Headersteuerelement ein. Sie können dieses Makro verwenden oder die HDM _ INSERTITEM-Nachricht explizit senden. |
| _Headerlayout | Ruft die richtige Größe und Position eines Header-Steuerelements 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 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 Header-Steuerelement fest. Sie können dieses Makro verwenden oder die _ HDM-Nachricht SETBITMAPMARGIN explizit senden. |
| Header _ SetFilterChangeTimeout | Legt das Timeoutintervall zwischen dem Zeitpunkt, zu dem eine Änderung in den Filterattributen stattfindet, und der Veröffentlichung einer HDN _ FILTERCHANGE-Benachrichtigung fest. Sie können dieses Makro verwenden oder die _ HDM-Nachricht SETFILTERCHANGETIMEOUT 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 Unterteilers zwischen Headerelementen, um das Ziel eines externen Drag & Drop-Vorgangs anzugeben. Sie können dieses Makro verwenden oder die _ HDM-Nachricht SETHOTDIVIDER explizit senden. |
| Header _ SetImageList | Weist einem vorhandenen Headersteuer steuerelement 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 der Headerelemente von links nach rechts fest. Sie können dieses Makro verwenden oder die HDM _ SETORDERARRAY-Nachricht explizit senden. |
| Header _ SetStateImageList | Weist einem vorhandenen Headersteuersteuerzustand eine Bildliste zu. |
| Header _ SetUnicodeFormat | Legt das UNICODE-Zeichenformatflag für das Steuerelement fest. Mit dieser Meldung können Sie den vom Steuerelement zur Laufzeit verwendeten Zeichensatz ändern, anstatt das Steuerelement neu erstellen zu müssen. Sie können dieses Makro verwenden oder die _ HDM-Nachricht SETUNICODEFORMAT explizit senden. |
Nachrichten
| Thema | Inhalte |
|---|---|
| HDM _ CLEARFILTER | Clears the filter for a given header control. (Löschen des Filters für ein bestimmtes Headersteuer steuerelement.) Sie können diese Nachricht explizit senden oder das _ ClearFilter-Makro Header verwenden. |
| HDM _ CREATEDRAGIMAGE | Erstellt eine halbtransparente Version des Bilds eines Elements zur Verwendung als Ziehbild. 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 Header _ DeleteItem-Makro verwenden. |
| HDM _ EDITFILTER | Verschiebt den Eingabefokus in das Bearbeitungsfeld, wenn eine Filterschaltfläche den Fokus besitzt. |
| HDM _ GETBITMAPMARGIN | Ruft die Breite des Bitmaprands für ein Header-Steuerelement ab. Sie können diese Nachricht explizit senden oder das _ Header-GetBitmapMargin-Makro verwenden. |
| HDM _ GETFOCUSEDITEM | Ruft das Element in einem Headersteuerelement ab, das den Fokus besitzt. Senden Sie diese Nachricht explizit oder mithilfe des _ Header-Makros 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 Header-Steuerelement festgelegt wurde. Sie können diese Nachricht explizit senden oder das Header _ GetImageList- oder Header _ GetStateImageList-Makro verwenden. |
| HDM _ GETITEM | Ruft Informationen zu einem Element in einem Headersteuerelement ab. Sie können diese Nachricht explizit senden oder das _ Header-GetItem-Makro verwenden. |
| HDM _ GETITEMCOUNT | Ruft die Anzahl der Elemente in einem Headersteuerelementen ab. Sie können diese Nachricht explizit senden oder das _ Header-GetItemCount-Makro verwenden. |
| HDM _ GETITEMDROPDOWNRECT | Ruft das umgebundene Rechteck der geteilten Schaltfläche für ein Headerelement im HDF _ SPLITBUTTON-Format ab. Senden Sie diese Nachricht explizit oder mithilfe des _ Header-GetItemDropDownRect-Makros. |
| HDM _ GETITEMRECT | Ruft das umgebundene Rechteck für ein bestimmtes Element in einem Headersteuerelement ab. Sie können diese Nachricht explizit senden oder das _ Header-GetItemRect-Makro verwenden. |
| HDM _ GETORDERARRAY | Ruft die aktuelle Reihenfolge von links nach rechts von Elementen in einem Headersteuerelementen ab. Sie können diese Nachricht explizit senden oder das _ Header-GetOrderArray-Makro verwenden. |
| HDM _ GETOVERFLOWRECT | Ruft das umgebundene Rechteck der Überlaufschaltfläche ab, wenn der HDS _ OVERFLOW-Stil für das Headersteuerfeld festgelegt ist und die Überlaufschaltfläche sichtbar ist. Senden Sie diese Nachricht explizit oder mithilfe des _ Header-Makros GetOverflowRect. |
| HDM _ GETUNICODEFORMAT | Ruft das Unicode-Zeichenformatflag 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 Headerelement sich am angegebenen Punkt befindet, sofern es sich um ein Headerelement handelt. |
| HDM _ INSERTITEM | Fügt ein neues Element in ein Headersteuerelement 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 Header-Steuerelements innerhalb des Zielrechtecks des übergeordneten Fensters verwendet werden. Sie können diese Nachricht explizit senden oder das Makro _ Headerlayout 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 _ OrderToIndex-Makro Header verwenden. |
| HDM _ SETBITMAPMARGIN | Legt die Breite des In Pixel angegebenen Rands einer Bitmap in einem vorhandenen Headersteuersatz fest. Sie können diese Nachricht explizit senden oder das _ Header-Makro SetBitmapMargin verwenden. |
| HDM _ SETFILTERCHANGETIMEOUT | Legt das Timeoutintervall zwischen dem Zeitpunkt, zu dem eine Änderung in den Filterattributen stattfindet, und der Veröffentlichung einer HDN _ FILTERCHANGE-Benachrichtigung fest. Sie können diese Nachricht explizit senden oder das _ Header-Makro SetFilterChangeTimeout verwenden. |
| HDM _ SETFOCUSEDITEM | Legt den Fokus auf ein angegebenes Element in einem Headersteuerelement fest. Senden Sie diese Nachricht explizit oder mithilfe des _ Header-Makros SetFocusedItem. |
| HDM _ SETHOTDIVIDER | Ändert die Farbe eines Unterteilers zwischen Headerelementen, um das Ziel eines externen Drag & Drop-Vorgangs anzugeben. Sie können diese Nachricht explizit senden oder das _ Header-SetHotDivider-Makro verwenden. |
| HDM _ SETIMAGELIST | Weist einem vorhandenen Headersteuer steuerelement 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 _ Header-SetItem-Makro verwenden. |
| HDM _ SETORDERARRAY | Legt die Reihenfolge der Headerelemente von links nach rechts fest. Sie können diese Nachricht explizit senden oder das _ Header-SetOrderArray-Makro verwenden. |
| HDM _ SETUNICODEFORMAT | Legt das UNICODE-Zeichenformatflag für das Steuerelement fest. Mit dieser Meldung können Sie den vom Steuerelement zur Laufzeit verwendeten Zeichensatz ändern, anstatt das Steuerelement neu erstellen zu müssen. Sie können diese Nachricht explizit senden oder das Header _ SetUnicodeFormat-Makro verwenden. |
| HDM _ TRANSLATEACCELERATOR | Nicht implementiert. |
Benachrichtigungen
| Thema | Inhalte |
|---|---|
| HDN _ BEGINDRAG | Wird von einem Headersteuerelementen gesendet, wenn ein Ziehvorgang für eines seiner Elemente begonnen hat. Dieser Benachrichtigungscode wird nur von Headersteuerelementen gesendet, die auf den HDS _ DRAGDROP-Stil festgelegt sind. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
| HDN _ BEGINFILTEREDIT | Benachrichtigt das übergeordnete Fenster eines Headersteuer elements, dass eine Filterbearbeitung begonnen hat. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
| HDN _ BEGINTRACK | Benachrichtigt das übergeordnete Fenster eines Headersteuerfelds, dass der Benutzer mit dem Ziehen eines Unterteilers im Steuerelement begonnen hat (d. h., der Benutzer hat die linke Maustaste gedrückt, während sich der Mauszeiger auf einem Unterteiler im Headersteuerfeld befindet). Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
| HDN _ DIVIDERDBLCLICK | Benachrichtigt das übergeordnete Fenster eines Header-Steuerelements, dass der Benutzer auf den Unterteilungsbereich des Steuerelements doppelklickt. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
| _HDN-DROPDOWNliste | Wird von einem Header-Steuerelement an das übergeordnete Steuerelement gesendet, wenn auf den Dropdownpfeil des Headersteuersteuer elements geklickt wird. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
| HDN _ ENDDRAG | Wird von einem Headersteuerelementen gesendet, wenn ein Ziehvorgang für eines seiner Elemente beendet wurde. Dieser Benachrichtigungscode wird als WM _ NOTIFY-Nachricht gesendet. Nur Headersteuerelemente, die auf den HDS _ DRAGDROP-Stil festgelegt sind, senden diese Benachrichtigung. |
| HDN _ ENDFILTEREDIT | Benachrichtigt das übergeordnete Fenster eines Headersteuer elements, dass eine Filterbearbeitung beendet wurde. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
| HDN _ ENDTRACK | Benachrichtigt das übergeordnete Fenster eines Header-Steuerelements, dass der Benutzer das Ziehen eines Unterteilers abgeschlossen hat. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
| _HDN-FILTERBTNCLICK | Benachrichtigt das übergeordnete Fenster des Headersteuerfelds, wenn auf die Filterschaltfläche oder als Reaktion auf eine HDM _ SETITEM-Meldung geklickt wird. |
| HDN _ FILTERCHANGE | Benachrichtigt das übergeordnete Fenster des Headersteuer elements, dass die Attribute eines Headersteuerfilters 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 Headerelements 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 Headerelements ändern werden. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
| HDN _ ITEMCLICK | Benachrichtigt das übergeordnete Fenster eines Headersteuer elements, 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 Headersteuer elements, dass der Benutzer auf das Steuerelement doppelklickt. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. Nur Headersteuerelemente, die auf den HDS _ BUTTONS-Stil festgelegt sind, senden diese Benachrichtigung. |
| HDN _ ITEMKEYDOWN | Benachrichtigt das übergeordnete Fenster eines Headersteuerelements, 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 Headersteuerelements, dass der Benutzer auf das Statussymbol eines Elements geklickt hat. |
| HDN _ OVERFLOWCLICK | Wird von einem Headersteuerfeld an das übergeordnete Element gesendet, wenn auf die Überlaufschaltfläche des Headers geklickt wird. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
| HDN _ TRACK | Benachrichtigt das übergeordnete Fenster eines Headersteuer elements, dass der Benutzer einen Unterteiler in das Headersteuerteiler-Steuerelement zieht. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
| NM _ CUSTOMDRAW (Header) | Wird von einem Header-Steuerelement 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 Strukturansicht-Steuerelements, dass der Benutzer im Steuerelement auf die rechte Maustaste geklickt hat. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
| NM _ RELEASEDCAPTURE (Header) | Benachrichtigt das übergeordnete Fenster eines Header-Steuerelements, dass das Steuerelement die Mauserfassung frei gibt. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet. |
Konstanten
| Thema | Inhalte |
|---|---|
| Header-Steuerelementstile | Headersteuerelemente verfügen über eine Reihe von Stilen, die in diesem Abschnitt beschrieben werden und die Darstellung und das Verhalten des Steuerelements bestimmen. Sie legen die anfänglichen Stile fest, wenn Sie das Header-Steuerelement erstellen. |