CMFCButton-Klasse

Artikel
02/26/2013

Die Klasse fügt CMFCButton-Funktionen der CButton-Klasse wie Einstimmung des Schaltflächentexts, Kombination des Schaltflächentexts und des Bilds, Auswählen eines Cursors und Angeben einer QuickInfo hinzu.

class CMFCButton : public CButton

Mitglieder

Öffentliche Konstruktoren

Name	Description
CMFCButton::CMFCButton	Standardkonstruktor.
CMFCButton::~CMFCButton	Destruktor.

Öffentliche Methoden

Name	Description
CMFCButton::CleanUp	Setzt interne Variablen zurück und gibt zugeordnete Ressourcen wie Bilder, Bitmaps und Symbole frei.
CMFCButton::CreateObject	Wird vom Framework, um eine dynamische Instanz dieses Klassentyps zu erstellen.
CMFCButton::DrawItem	Aufgerufen vom Framework ausgelöst, wenn ein visueller Aspekt einer Ownerdrawnschaltfläche geändert hat.(Überschreibungen CButton::DrawItem.)
CMFCButton::EnableFullTextTooltip	Gibt an, ob der Text einer QuickInfo in einem großen QuickInfo-Fenster oder eine abgeschnittene Version des Texts in einem kleinen QuickInfo-Fenster angezeigt wird.
CMFCButton::EnableMenuFont	Gibt an, ob die Schaltflächentextschriftart mit der Anwendungsmenüschriftart ist.
CMFCButton::EnableWindowsTheming	Gibt an, ob das Format der Knopfleiste dem Design der aktiven Fenster entspricht.
CMFCButton::GetThisClass	Wird vom Framework, um ein Zeiger auf CRuntimeClass-Objekt abzurufen, das diesem Klassentyp zugeordnet ist.
CMFCButton::GetToolTipCtrl	Gibt einen Verweis auf den zugrunde liegenden QuickInfosteuerelement zurück.
CMFCButton::IsAutoCheck	Gibt an, ob ein Kontrollkästchen oder ein Optionsfeld eine automatische Schaltfläche ist.
CMFCButton::IsAutorepeatCommandMode	Gibt an, ob eine Schaltfläche zu AUTOREPEAT-Modus festgelegt ist.
CMFCButton::IsCheckBox	Gibt an, ob eine Schaltfläche eine Kontrollkästchenschaltfläche ist.
CMFCButton::IsChecked	Gibt an, ob die aktuelle Schaltfläche überprüft wird.
CMFCButton::IsHighlighted	Gibt an, ob eine Schaltfläche hervorgehoben wird.
CMFCButton::IsPressed	Gibt an, ob eine Schaltfläche gedrückt und hervorgehoben wird.
CMFCButton::IsPushed	Gibt an, ob eine Schaltfläche gedrückt ist.
CMFCButton::IsRadioButton	Gibt an, ob eine Schaltfläche ein Optionsfeld ist.
CMFCButton::IsWindowsThemingEnabled	Gibt an, ob das Format der Knopfleiste dem Design der aktiven Fenster entspricht.
CMFCButton::OnDrawParentBackground	Zeichnet den Hintergrund des übergeordneten Elements einer Schaltfläche im angegebenen Bereich.(Überschreibungen AFX_GLOBAL_DATA::DrawParentBackground.)
CMFCButton::PreTranslateMessage	Übersetzt Fenstermeldungen, bevor sie an den TranslateMessage und DispatchMessage Windows-Funktionen weitergeleitet werden.(Überschreibungen CWnd::PreTranslateMessage.)
CMFCButton::SetAutorepeatMode	Legt eine Schaltfläche zu AUTOREPEAT-Modus fest.
CMFCButton::SetCheckedImage	Legt das Bild für eine überprüfte Schaltfläche fest.
CMFCButton::SetFaceColor	Legt die Hintergrundfarbe für den Schaltflächentext fest.
CMFCButton::SetImage	Legt das Bild für eine Schaltfläche fest.
CMFCButton::SetMouseCursor	Legt das Cursor-Image fest.
CMFCButton::SetMouseCursorHand	Legt den Cursor zum Bild einer Hand fest.
CMFCButton::SetStdImage	Wird ein CMenuImages-Objekt, um das Schaltflächensymbol festzulegen.
CMFCButton::SetTextColor	Legt die Farbe des Schaltflächentexts für eine Schaltfläche fest, die nicht ausgewählt ist.
CMFCButton::SetTextHotColor	Legt die Farbe des Schaltflächentexts für eine Schaltfläche fest, die ausgewählt ist.
CMFCButton::SetTooltip	Ordnet eine QuickInfo mit einer Schaltfläche auf.
CMFCButton::SizeToContent	Ändert eine Schaltfläche Größe, um den Schaltflächentext und -Image zu enthalten.

Geschützte Methoden

Name	Description
CMFCButton::OnDraw	Aufgerufen vom Framework, um eine Schaltfläche zu zeichnen.
CMFCButton::OnDrawBorder	Aufgerufen vom Framework, um den Kontext einer Schaltfläche zu zeichnen.
CMFCButton::OnDrawFocusRect	Aufgerufen vom Framework, um das Fokusrechteck für eine Schaltfläche zu zeichnen.
CMFCButton::OnDrawText	Aufgerufen durch das Framework, um den Schaltflächentext zu zeichnen.
CMFCButton::OnFillBackground	Aufgerufen durch das Framework, um den Hintergrund des Schaltflächentexts zu zeichnen.
CMFCButton::SelectFont	Ruft die Schriftart ab, die dem angegebenen Gerätekontext zugeordnet ist.

Datenmember

Name	Description
CMFCButton::m_bDrawFocus	Gibt an, ob ein Fokusrechteck um eine Schaltfläche gezeichnet wird.
CMFCButton::m_bHighlightChecked	Gibt an, ob ein BS_CHECKBOX-style " hervorhebt, wenn der Cursor darauf gezeigt.
CMFCButton::m_bRightImage	Gibt an, ob ein Bild auf der rechten Seite der Schaltfläche angezeigt wird.
CMFCButton::m_bTransparent	Gibt an, ob die Schaltfläche transparent ist.
CMFCButton::m_nAlignStyle	Gibt die Ausrichtung des Schaltflächentexts an.
CMFCButton::m_nFlatStyle	Gibt das Format der Schaltfläche, wie grenzenfreies, zurück, halbflaches oder 3D an.

Hinweise

Andere Typen Schaltflächen werden von der CMFCButton-Klasse, wie der CMFCURLLinkButton-Klasse, die Links unterstützt, und der CMFCColorButton-Klasse abgeleitet, die ein Farben-Auswahldialogfeld unterstützt.

Das Format eines Objekts kann CMFCButton3D, flach, halbflaches sein oder kein Rahmen.Schaltflächentext kann links ausgerichtet werden, oberen oder Mittelpunkt einer Schaltfläche.Zur Laufzeit können Sie steuern, ob die auf, ein Bild oder Text und ein Bild Text.Sie können auch angeben, dass ein bestimmtes Cursor-Image angezeigt wird, wenn der Cursor auf einer Schaltfläche zeigt.

Erstellen Sie ein Button-Steuerelement entweder direkt im Code oder das Tool MFC-Klassen-Assistent und eine Dialogfeldvorlage verwenden.Wenn Sie ein Button-Steuerelement direkt erstellen, fügen Sie eine CMFCButton-Variable der Anwendung hinzu, und rufen Sie dann den Konstruktor auf und Create-Methoden CMFCButton ein Objekt.Wenn Sie MFC-Klassen-Assistent verwenden, fügen Sie eine CButton-Variable der Anwendung hinzu, und ändern Sie dann den Typ der Variablen von CButton zu CMFCButton.

Um Benachrichtigungsmeldungen in einer Dialogfeld-Anwendung zu bearbeiten, fügen Sie einen Eintrag in der Meldungszuordnung und Ereignishandler für jede Benachrichtigung hinzu.Die Benachrichtigungen, die durch ein CMFCButton-Objekt gesendet werden, sind identisch mit denen, die von einem CButton-Objekt gesendet werden.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie die Eigenschaften der Schaltfläche konfiguriert, indem verschiedene Methoden in der CMFCButton-Klasse angewendet wird.Das Beispiel ist Teil Neue Kontrollprobe.

    CMFCButton m_Button;


...


    // int m_iImage
    // IDB_BTN1_32, IDB_BTN1_HOT_32, IDB_BTN1, IDB_BTN1_HOT are int macros that are #define.
    if (m_iImage == 1) 
    {
        m_Button.SetImage((HBITMAP) NULL);
    }
    else
    {
        m_Button.SetImage(IDB_BTN1_32, IDB_BTN1_HOT_32);
    }


...


    // int m_iImage
    if (m_iImage == 0)
    {
        m_Button.SetWindowText(_T(""));
    }
    else
    {
        m_Button.SetWindowText(_T("Button"));
    }


...


    // Resize the button.
    m_Button.SizeToContent();
    m_Button.EnableFullTextTooltip(true);
    // Use the application menu font at the button text font.
    m_Button.EnableMenuFont();
    // Use the current Windows theme to draw the button borders.
    m_Button.EnableWindowsTheming(true);
    // Set the button to auto-repeat mode.
    m_Button.SetAutorepeatMode();
    // Set the background color for the button text.
    m_Button.SetFaceColor(RGB(255,0,0),true);
    m_Button.SetTextColor(RGB(0,0,255));
    // Set the tooltip of the button.
    m_Button.SetTooltip(_T("this is a button!"));