Informationen zu Headersteuerelementen

Ein Kopfzeilensteuerelement ist ein Fenster, das in der Regel oberhalb von Text- oder Zahlenspalten positioniert ist. Sie enthält einen Titel für jede Spalte und kann in Teile unterteilt werden. Der Benutzer kann die Trennlinien ziehen, die die Teile trennen, um die Breite der einzelnen Spalten festzulegen. Die folgende Abbildung zeigt ein Headersteuerelement mit beschrifteten Spalten, die detaillierte Informationen zu Dateien in einem Verzeichnis enthalten.

Sie können ein Headersteuerelement erstellen, indem Sie die CreateWindowEx-Funktion verwenden und dabei die WC_HEADER Fensterklasse und die entsprechenden Headersteuerelementstile angeben. Diese Fensterklasse wird registriert, wenn die allgemeine Steuerelement-DLL geladen wird. Verwenden Sie die Funktion InitCommonControlsEx , um sicherzustellen, dass diese DLL geladen wird. Nachdem Sie ein Headersteuerelement erstellt haben, können Sie es in Teile unterteilen, den Text in jedem Teil festlegen und die Darstellung des Fensters mithilfe von Headerfenstermeldungen steuern.

Ein Headersteuerelement kann als untergeordnetes Fenster eines anderen Steuerelements erstellt werden, z. B. als Listenfeld. Das übergeordnete Steuerelement kennt das Headersteuerelement jedoch nicht und lässt den vom Header belegten Speicherplatz nicht zu, sodass Listenelemente hinter dem Header angezeigt werden. Wenn Sie ein Kopfzeilensteuerelement in einem Listenfeld oder einem anderen Steuerelement verwenden möchten, muss das übergeordnete Steuerelement besitzerseitig gezeichnet werden, damit alle Elemente an der richtigen Position angezeigt werden.

Listenansichtssteuerelemente verfügen bereits über Headersteuerelemente. Anstatt ein Headersteuerelement für ein Listenansichtssteuerelement zu erstellen, verwenden Sie LVM_GETHEADER oder ListView_GetHeader , um das vorhandene Steuerelement abzurufen.

• Größe und Position des Headersteuerelements
• Elemente
• Von Besitzern gezeichnete Headersteuerelemente
• Filter für Headersteuerelemente
• Standardmäßige Headersteuerelement-Nachrichtenverarbeitung

Größe und Position des Headersteuerelements

In der Regel müssen Sie die Größe und Position eines Headersteuerelements so festlegen, dass sie in die Grenzen eines bestimmten Rechtecks passen, z. B. der Clientbereich eines Fensters. Mithilfe der HDM_LAYOUT-Nachricht können Sie die entsprechenden Größen- und Positionswerte aus dem Headersteuerelement abrufen.

Wenn Sie HDM_LAYOUT senden, geben Sie die Adresse einer HDLAYOUT-Struktur an, die die Koordinaten des Rechtecks enthält, das das Headersteuerelement belegen soll, und stellt einen Zeiger auf eine WINDOWPOS-Struktur bereit. Das Steuerelement füllt die WINDOWPOS-Struktur mit Größen- und Positionswerten aus, die zum Positionieren des Steuerelements am oberen Rand des angegebenen Rechtecks geeignet sind. Der Height-Wert ist die Summe der Höhe der horizontalen Rahmen des Steuerelements und der durchschnittlichen Höhe der Zeichen in der Schriftart, die derzeit im Gerätekontext des Steuerelements ausgewählt ist.

Wenn Sie HDM_LAYOUT verwenden möchten, um die Anfangsgröße und Position eines Headersteuerelements festzulegen, legen Sie den anfänglichen Sichtbarkeitsstatus des Steuerelements so fest, dass es ausgeblendet wird. Nachdem Sie HDM_LAYOUT gesendet haben, um die Größen- und Positionswerte abzurufen, können Sie die SetWindowPos-Funktion verwenden, um die neue Größe, Position und den neuen Sichtbarkeitsstatus festzulegen.

Items

Ein Headersteuerelement verfügt in der Regel über mehrere Headerelemente, die die Spalten des Steuerelements definieren. Sie fügen einem Headersteuerelement ein Element hinzu, indem Sie die HDM_INSERTITEM-Nachricht an das Steuerelement senden. Die Nachricht enthält die Adresse einer HDITEM-Struktur . Diese Struktur definiert die Eigenschaften des Headerelements, die eine Zeichenfolge, ein Bitmapbild, eine Anfangsgröße und einen anwendungsdefinierten LPARAM-Wert enthalten können.

Das fmt-Element der HDITEM-Struktur eines Elements kann entweder das HDF_STRING - oder HDF_BITMAP-Flag enthalten, um anzugeben, ob das Steuerelement die Zeichenfolge oder Bitmap des Elements anzeigt. Wenn Sie sowohl eine Zeichenfolge als auch eine Bitmap anzeigen möchten, erstellen Sie ein vom Besitzer gezeichnetes Element, indem Sie das fmt-Element so festlegen, dass das flag HDF_OWNERDRAW eingeschlossen wird. Die HDITEM-Struktur gibt auch Formatierungsflags an, die dem Steuerelement mitteilen, ob die Zeichenfolge oder Bitmap im Rechteck des Elements zentriert, linksbündig oder rechts ausgerichtet werden soll.

HDM_INSERTITEM gibt den Index des neu hinzugefügten Elements zurück. Sie können den Index in anderen Nachrichten verwenden, um Eigenschaften festzulegen oder Informationen über das Element abzurufen. Sie können ein Element löschen, indem Sie die HDM_DELETEITEM Nachricht verwenden und dabei den Index des zu löschenden Elements angeben.

Sie können die HDM_SETITEM Nachricht verwenden, um die Eigenschaften eines vorhandenen Headerelements und die HDM_GETITEM Nachricht festzulegen, um die aktuellen Eigenschaften eines Elements abzurufen. Verwenden Sie die HDM_GETITEMCOUNT Nachricht, um die Anzahl der Elemente in einem Headersteuerelement abzurufen.

Owner-Drawn-Headersteuerelemente

Sie können einzelne Elemente eines Headersteuerelements als besitzergezeichnete Elemente definieren. Wenn Sie dieses Verfahren verwenden, haben Sie mehr Kontrolle über die Darstellung eines Kopfzeilenelements, als sie andernfalls hätten.

Sie können die HDM_INSERTITEM Nachricht verwenden, um ein neues vom Besitzer gezeichnetes Element in ein Kopfzeilensteuerelement oder die HDM_SETITEM-Nachricht einzufügen, um ein vorhandenes Element in ein vom Besitzer gezeichnetes Element zu ändern. Beide Nachrichten enthalten die Adresse einer HDITEM-Struktur , für die der fmt-Member auf den HDF_OWNERDRAW-Wert festgelegt sein sollte.

Wenn ein Headersteuerelement ein vom Besitzer gezeichnetes Element zeichnen muss, sendet es die WM_DRAWITEM Nachricht an das übergeordnete Fenster. Der wParam-Parameter der Nachricht ist der bezeichner des untergeordneten Fensters des Headersteuerelements, und der lParam-Parameter ist eine Adresse einer DRAWITEMSTRUCT-Struktur . Das übergeordnete Fenster verwendet die Informationen in der -Struktur, um das Element zu zeichnen. Für ein vom Besitzer gezeichnetes Element in einem Headersteuerelement enthält die DRAWITEMSTRUCT-Struktur die folgenden Informationen.

Filter für Headersteuerelemente

Durch Angeben des HDS_FILTERBAR Fensterstils für ein Headersteuerelement können Sie die Platzierung von Filterbearbeitungsfeldern unter den Spaltenüberschriften aktivieren. Neben dem Bearbeitungsfeld wird eine Filterschaltfläche angezeigt. Sie können die Filterung implementieren, indem Sie auf HDN_BEGINFILTEREDIT, HDN_ENDFILTEREDIT, HDN_FILTERBTNCLICK oder HDN_FILTERCHANGE Benachrichtigungscodes reagieren.

Standardmäßig enthält das Bearbeitungsfeld eine Aufforderung für den Benutzer, Text einzugeben. Sie können das Bearbeitungsfeld mithilfe von Header_ClearFilter oder Header_ClearAllFilters auf diesen Standardzustand wiederherstellen.

Das folgende Codebeispiel zeigt, wie Sie das Headersteuerelement aus einem Listenansicht-Steuerelement abrufen und eine Filterleiste hinzufügen.

// hList is the HWND of the list-view control.
HWND hHeader = ListView_GetHeader(hList);
LONG_PTR styles = GetWindowLongPtr(hHeader, GWL_STYLE);
SetWindowLongPtr(g_hHeader, GWL_STYLE, styles | HDS_FILTERBAR);

Standardmäßige Headersteuerelement-Nachrichtenverarbeitung

In diesem Abschnitt werden die Fenstermeldungen beschrieben, die von der Fensterprozedur für die WC_HEADER-Fensterklasse verarbeitet werden.