Freigeben über


CHeaderCtrl::Create

Erstellt ein und fügt es Header-Steuerelement zu einem CHeaderCtrl-Objekt.

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

Parameter

  • dwStyle
    Gibt das Format des Header-Steuerelements an.Eine Beschreibung der Header-Steuerelement-Formaten, finden Sie unter Header-Steuerelement-Formate in Windows SDK.

  • rect
    Gibt des die Größe und Position Header-Steuerelements an.Sie kann ein CRect-Objekt oder eine Struktur RECT sein.

  • pParentWnd
    Gibt das übergeordnete Fenster des Header-Steuerelements, normalerweise CDialog an.Er darf nicht NULL sein.

  • nID
    Gibt die ID des Header-Steuerelements an

Rückgabewert

Ungleich 0 (null), wenn die Initialisierung erfolgreich war; null andernfalls.

Hinweise

Sie erstellen ein CHeaderCtrl-Objekt in zwei Schritten.Zuerst rufen Sie den Konstruktor auf und dann auf Create, der das Header-Steuerelement erstellt und auf CHeaderCtrl-Objekt angefügt werden.

Zusätzlich zu den Header-Steuerelement-Formaten können Sie die folgenden Formate für allgemeine Steuerelemente verwenden, um zu bestimmen, wie das Header-Steuerelement positioniert und die Größe ändert (siehe Formate für allgemeine Steuerelemente weitere Informationen):

  • CCS_BOTTOM bewirkt, dass das Steuerelement sich am unteren Rand des Clientbereichs des übergeordneten Fensters zu positionieren und legt die Breite fest, um dasselbe wie die Breite des übergeordneten Fensters zu sein.

  • CCS_NODIVIDER verhindert eine ZweiPixel Markierung an gezeichnet werden am oberen Rand des Steuerelements.

  • CCS_NOMOVEY bewirkt, dass das Steuerelement, als Reaktion auf eine WM_SIZE Nachricht nicht vertikal angepasst und horizontal, sich aber zu verschieben.Wenn das CCS_NORESIZE Format verwendet wird, wird dieses Format nicht zu.Header-Steuerelemente haben dieses Format standardmäßig.

  • CCS_NOPARENTALIGN verhindert das Steuerelement an den oberen bzw. unteren Rand des übergeordneten Fensters automatisch wechseln.Stattdessen enthält das Steuerelement seine Position innerhalb des übergeordneten Fensters ungeachtet der Änderungen an der Größe des übergeordneten Fensters.Wenn das CCS_TOP oder CCS_BOTTOM Format auch verwendet wird, wird die Höhe für den Standardanbieter angepasst, aber die Position und die Breite bleiben unverändert.

  • CCS_NORESIZE verhindert das Steuerelement an der Verwendung der standardmäßigen Breite und Höhe, wenn es seine ursprüngliche Größe oder eine neue Größe festgelegt.Stattdessen verwendet das Steuerelement die Breite und Höhe, die im Anforderungen für Erstellung oder Größenanpassung angegeben werden.

  • CCS_TOP bewirkt, dass das Steuerelement sich am oberen Rand des Clientbereichs des übergeordneten Fensters zu positionieren und legt die Breite fest, um dasselbe wie die Breite des übergeordneten Fensters zu sein.

Sie können die folgenden Fensterstile auf ein Header-Steuerelement gelten auch (siehe Fensterstile weitere Informationen):

  • WS_CHILD stellt ein untergeordnetes Fenster erstellt.Kann nicht mit dem WS_POPUP Format verwendet werden.

  • WS_VISIBLE wird ein Fenster erstellt, das zuerst sichtbar ist.

  • WS_DISABLED wird ein Fenster erstellt, das zuerst deaktiviert ist.

  • WS_GROUP gibt das erste Steuerelement einer Gruppe von Steuerelementen an, in denen der Benutzer von einem Steuerelement zum nächsten mit den Pfeiltasten verschieben kann.Alle Steuerelemente, die mit dem WS_GROUP Format nach dem ersten - Steuerelement definiert werden, gehören derselben Gruppe.Das folgende - Steuerelement mit dem WS_GROUP Format beendet die Formatgruppe und beginnt die folgende Gruppe (das heißt, beendet eine Gruppe, wo das folgende beginnt).

  • WS_TABSTOP gibt ein beliebig vielen Steuerelementen an, durch die der Benutzer wechseln kann, indem er die TAB-TASTE verwendet.Mit der TAB-TASTE verschieben den Benutzer auf das nächste Steuerelement, das vom WS_TABSTOP Format angegeben wird.

Wenn Sie erweiterte Fensterformate mit dem Steuerelement verwenden möchten, rufen Sie CreateEx anstelle Create auf.

Beispiel

// pParentWnd is a pointer to the parent window.
m_myHeaderCtrl.Create(WS_CHILD | WS_VISIBLE | HDS_HORZ,
   CRect(10, 10, 600, 50), pParentWnd, 1);

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CHeaderCtrl-Klasse

Hierarchien-Diagramm

CHeaderCtrl::CHeaderCtrl