Classe de CMFCButton

Article
03/04/2013

La classe d' CMFCButton ajoute des fonctionnalités à la classe de CButton comme aligner le texte du bouton, combiner le texte du bouton et une image, sélectionnez un curseur, et spécifier une info-bulle.

class CMFCButton : public CButton

Membres

Constructeurs publics

Nom	Description
CMFCButton::CMFCButton	Constructeur par défaut.
CMFCButton::~CMFCButton	Destructor.

Méthodes publiques

Nom	Description
CMFCButton::CleanUp	Réinitialise les variables internes et libère les ressources allouées telles que les images, des images, des icônes.
CMFCButton::CreateObject	Utilisé par l'infrastructure pour créer une instance dynamique de ce type de classe.
CMFCButton::DrawItem	Appelé par l'infrastructure lorsqu'un aspect visuel d'un bouton owner-drawn a changé.(Substitutions CButton::DrawItem.)
CMFCButton::EnableFullTextTooltip	Spécifie s'il faut afficher le texte intégral d'une info-bulle dans une large fenêtre d'info-bulle ou une version tronquée du texte dans une petite fenêtre d'info-bulle.
CMFCButton::EnableMenuFont	Spécifie si la police du texte du bouton est la même que la police de menu application.
CMFCButton::EnableWindowsTheming	Spécifie si le style de la bordure du bouton correspond au thème windows actuel.
CMFCButton::GetThisClass	Utilisé par l'infrastructure pour obtenir un pointeur vers l'objet de CRuntimeClass associé à ce type de classe.
CMFCButton::GetToolTipCtrl	Retourne une référence au contrôle d'info-bulle sous-jacent.
CMFCButton::IsAutoCheck	Indique si une case à cocher ou une case d'option est un bouton automatique.
CMFCButton::IsAutorepeatCommandMode	Indique si un bouton est défini en mode de répétition automatique.
CMFCButton::IsCheckBox	Indique si un bouton est un bouton de case à cocher.
CMFCButton::IsChecked	Indique si le bouton actuel est activée.
CMFCButton::IsHighlighted	Indique si un bouton est mis en surbrillance.
CMFCButton::IsPressed	Indique si un bouton est enfoncé et mis en surbrillance.
CMFCButton::IsPushed	Indique si un bouton est enfoncé.
CMFCButton::IsRadioButton	Indique si un bouton est une case d'option.
CMFCButton::IsWindowsThemingEnabled	Indique si le style de la bordure du bouton correspond au thème windows actuel.
CMFCButton::OnDrawParentBackground	Dessine l'arrière-plan du parent d'un bouton dans la zone spécifiée.(Substitutions AFX_GLOBAL_DATA::DrawParentBackground.)
CMFCButton::PreTranslateMessage	Traduit des messages de fenêtre pour qu'ils soient distribués aux fonctions Windows de TranslateMessage et de DispatchMessage .(Substitutions CWnd::PreTranslateMessage.)
CMFCButton::SetAutorepeatMode	Définit un bouton au mode de répétition automatique.
CMFCButton::SetCheckedImage	Définit l'image pour un bouton est activé.
CMFCButton::SetFaceColor	Définit la couleur d'arrière-plan pour le texte du bouton.
CMFCButton::SetImage	Définit l'image pour un bouton.
CMFCButton::SetMouseCursor	Définit l'image du curseur.
CMFCButton::SetMouseCursorHand	Place le curseur vers l'image d'une main.
CMFCButton::SetStdImage	Utilise un objet d' CMenuImages pour définir l'image de bouton.
CMFCButton::SetTextColor	Définit la couleur du texte du bouton pour un bouton qui n'est pas sélectionné.
CMFCButton::SetTextHotColor	Définit la couleur du texte du bouton pour un bouton qui est sélectionné.
CMFCButton::SetTooltip	Associe une info-bulle avec un bouton.
CMFCButton::SizeToContent	Redimensionne un bouton pour contenir le texte du bouton et image.

Méthodes protégées

Nom	Description
CMFCButton::OnDraw	Appelé par l'infrastructure pour dessiner un bouton.
CMFCButton::OnDrawBorder	Appelé par l'infrastructure pour dessiner la bordure d'un bouton.
CMFCButton::OnDrawFocusRect	Appelé par l'infrastructure pour dessiner un rectangle de focus d'un bouton.
CMFCButton::OnDrawText	Appelé par l'infrastructure pour dessiner le texte du bouton.
CMFCButton::OnFillBackground	Appelé par l'infrastructure pour dessiner l'arrière-plan du texte du bouton.
CMFCButton::SelectFont	Extrait la police associée au contexte spécifié de périphérique.

Membres de données

Nom	Description
CMFCButton::m_bDrawFocus	Indique si dessiner un rectangle de focus autour d'un bouton.
CMFCButton::m_bHighlightChecked	Indique si la mise en surbrillance un BS_CHECKBOX-style bouton événements lorsque le curseur pointe sur lui.
CMFCButton::m_bRightImage	Indique s'afficher une image à droite du bouton.
CMFCButton::m_bTransparent	Indique si le bouton est transparent.
CMFCButton::m_nAlignStyle	Spécifie l'alignement du texte du bouton.
CMFCButton::m_nFlatStyle	Spécifie le style du bouton, tel que sans frontière, en deux dimensions, le semi- plate, ou le 3D.

Notes

D'autres types de boutons sont dérivés de la classe d' CMFCButton , comme la classe de CMFCURLLinkButton , qui prend en charge des liens hypertexte, et la classe d' CMFCColorButton , qui prend en charge une boîte de dialogue du sélecteur de couleurs.

Le style d'un objet d' CMFCButton peut être 3D, plate, semi- plate ou aucune bordure.Le texte du bouton peut être aligné à gauche, haut, ou centre d'un bouton.Au moment de l'exécution, vous pouvez contrôler si les affichages de bouton du texte, une image, ou texte et une image.Vous pouvez également spécifier qu'une image particulière du curseur soit affichée lorsque le curseur pointe sur un bouton.

Créez un contrôle bouton directement dans votre code, ou en utilisant l'outil assistant Classe MFC et d'un modèle de boîte de dialogue.Si vous créez un contrôle bouton directement, ajoutez une variable d' CMFCButton à votre application, puis appelez le constructeur et les méthodes d' Create d' CMFCButton objet.Si vous utilisez assistant Classe MFC, ajoutez une variable d' CButton à votre application, puis modifiez le type de la variable d' CButton par CMFCButton.

Pour gérer des messages de notification dans une application de boîte de dialogue, ajoutez une entrée de la table des messages et un gestionnaire d'événements pour chaque notification.Les notifications envoyées par un objet d' CMFCButton sont les mêmes que celles envoyées par un objet d' CButton .

Exemple

L'exemple suivant montre comment configurer les propriétés du bouton en utilisant différentes méthodes dans la classe d' CMFCButton .l'exemple fait partie de Nouvel exemples de contrôles.

    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!"));