CButton-Klasse

Artikel
06/10/2015

Stellt die Funktionalität von Windows-Schaltflächen-Steuerelementen bereit.

class CButton : public CWnd

Mitglieder

Öffentliche Konstruktoren

Name	Description
CButton::CButton	Erstellt ein CButton-Objekt.

Öffentliche Methoden

Name	Description
CButton::Create	Erstellt das Schaltflächen-Steuerelement von Windows und fügt es dem CButton-Objekt.
CButton::DrawItem	Überschreiben Sie, um ein Ownerdrawn-CButton-Objekt zu zeichnen.
CButton::GetBitmap	Ruft das Handle der Bitmap ab, die zuvor mit SetBitmap festgelegt ist.
CButton::GetButtonStyle	Ruft Informationen zum Schaltflächen-Steuerelement-Format ab.
CButton::GetCheck	Ruft den Aktivierungszustand eines Button-Steuerelements ab.
CButton::GetCursor	Ruft das Handle des Cursorbilder ab, die zuvor mit SetCursor festgelegt ist.
CButton::GetIcon	Ruft das Handle des Symbols ab, die zuvor mit SetIcon festgelegt ist.
CButton::GetIdealSize	Ruft die ideale Größe des Button-Steuerelements ab.
CButton::GetImageList	Ruft die Bildliste des Button-Steuerelements ab.
CButton::GetNote	Ruft die Hinweiskomponente des aktuellen Befehlslink-steuerelements ab.
CButton::GetNoteLength	Ruft die Länge des Hinweistexts für das aktuelle Befehlslink-steuerelement ab.
CButton::GetSplitGlyph	Ruft das Symbol ab, das dem aktuellen SplitButton-Steuerelement zugeordnet ist.
CButton::GetSplitImageList	Ruft die Bildliste für das aktuelle SplitButton-Steuerelement ab.
CButton::GetSplitInfo	Ruft Informationen ab, die das aktuelle SplitButton-Steuerelement definiert.
CButton::GetSplitSize	Ruft das umschließende Rechteck der Dropdown-Komponente des aktuellen Steuerelements der Auswahlschaltfläche ab.
CButton::GetSplitStyle	Ruft die Formate der Auswahlschaltfläche ab, die das aktuelle SplitButton-Steuerelement definieren.
CButton::GetState	Ruft den Aktivierungszustand, den Hervorhebungszustand und den Fokusenzustand eines Button-Steuerelements ab.
CButton::GetTextMargin	Ruft den Textrand des Button-Steuerelements ab.
CButton::SetBitmap	Gibt eine auf an der Schaltfläche angezeigt werden Bitmap.
CButton::SetButtonStyle	Ändert das Format einer Schaltfläche.
CButton::SetCheck	Legt den Aktivierungszustand eines Button-Steuerelements fest.
CButton::SetCursor	Gibt ein auf der Schaltfläche an angezeigt werden Cursor-Image.
CButton::SetDropDownState	Legt den Dropdown-Zustand des aktuellen Steuerelements der Auswahlschaltfläche fest.
CButton::SetIcon	Gibt ein auf an der Schaltfläche angezeigt werden Symbol.
CButton::SetImageList	Legt die Bildliste des Button-Steuerelements fest.
CButton::SetNote	Legt den Hinweis über das aktuelle Befehlslink-steuerelement fest.
CButton::SetSplitGlyph	Ordnet ein bestimmtes Symbol mit dem aktuellen SplitButton-Steuerelement zu.
CButton::SetSplitImageList	Ordnet eine Bildliste mit dem aktuellen SplitButton-Steuerelement zu.
CButton::SetSplitInfo	Gibt Informationen an, die das aktuelle SplitButton-Steuerelement definiert.
CButton::SetSplitSize	Legt das umschließende Rechteck der Dropdown-Komponente des aktuellen Steuerelements der Auswahlschaltfläche fest.
CButton::SetSplitStyle	Legt das Format des aktuellen Steuerelements der Auswahlschaltfläche fest.
CButton::SetState	Legt den Hervorhebungszustand eines Button-Steuerelements fest.
CButton::SetTextMargin	Legt den Textrand des Button-Steuerelements fest.

Hinweise

Ein Schaltflächen-Steuerelement ist ein kleines, rechteckiges untergeordnetes Fenster, auf das an und weg geklickt werden kann. Schaltflächen können in Gruppen allein oder verwendet werden und entweder beschriftet sind oder ohne Text angezeigt werden. Eine Schaltfläche ändert in der Regel Darstellung, wenn der Benutzer darauf klickt.

Typische Schaltflächen sind das Kontrollkästchen, das Optionsfeld und der Pushbutton. Ein Objekt CButton kann diese, entsprechend Schaltflächenformat werden, das an der Initialisierung von der Erstellen Sie-Memberfunktion angegeben wird.

Darüber hinaus unterstützt die CBitmapButton-Klasse, die von abgeleitet ist, CButton Erstellung von Schaltflächen-Steuerelemente, die mit Bitmap-Bildern anstelle von Text bezeichnet werden. CBitmapButton kann separate Bitmaps für eine Schaltfläche oben, unten liegt und deaktivierte Status haben.

Sie können ein Schaltflächen-Steuerelement entweder einer Dialogfeldvorlage oder direkt im Code erstellen. In beiden Fällen zunächst der Konstruktor CButton, um CButton des Objekts zu erstellen; Rufen Sie dann die Create-Memberfunktion auf, um das Schaltflächen-Steuerelement von Windows zu erstellen und auf CButton-Objekt anzufügen.

Konstruktion kann ein nur einen Schritt umfassender Prozess in einer Klasse sein, die von CButton abgeleitet wird. Schreiben Sie einen Konstruktor für die abgeleitete Klasse und rufen Sie Create aus dem Konstruktor auf.

Wenn Sie Windows-Benachrichtigungsmeldungen bearbeiten möchten, die durch ein Schaltflächen-Steuerelement zu seinem übergeordneten Element gesendet werden (normalerweise eine Klasse wird von abgeleitet CDialog-Klasse), fügen Sie eine Meldungszuordnungseintrags- und Meldungshandlermemberfunktion der übergeordneten Klasse für jede Meldung hinzu.

Jeder Eintrag in der Meldungszuordnung weist folgende Form auf:

ON_ Benachrichtigung (id, memberFxn)

wobei id die ID des untergeordneten Fensters sendenden des Steuerelements, ist die Benachrichtigungen und memberFxn der Name der übergeordneten Memberfunktion, die Sie geschrieben haben, um die Benachrichtigung zu bearbeiten.

Der Funktionsprototyp des übergeordneten Elements ist, wie folgt:

afx_msgvoidmemberFxn**( );**

Mögliche Meldungszuordnungseinträge sind, wie folgt:

Zuordnungseintrag	Gesendet, um zum übergeordneten Element, wenn...
ON_BN_CLICKED	Der Benutzer klickt auf eine Schaltfläche.
ON_BN_DOUBLECLICKED	Der Benutzer doppelklickt auf eine Schaltfläche.

Wenn Sie ein CButton-Objekt aus einer Dialogfeldressource erstellen, wird das Objekt CButton automatisch zerstört, wenn der Benutzer das Dialogfeld geschlossen wird.

Wenn Sie ein CButton-Objekt innerhalb eines Fensters erstellen, müssen Sie es zerstören. Wenn Sie das CButton-Objekt auf dem Heap erstellen, indem Sie die new-Funktion verwenden, müssen Sie delete für das Objekt aufrufen, um es zu zerstören, wenn der Benutzer das Schaltflächen-Steuerelement von Windows enthält. Wenn Sie das CButton-Objekt auf dem Stapel erstellen oder er im übergeordneten Dialogfeldobjekt eingebettet wird, wird er automatisch zerstört.