Classe di CMFCButton

Articolo
02/19/2013

La classe CMFCButton aggiunge funzionalità alla classe CButton come allineare il testo del pulsante, la combinazione il testo del pulsante e image, selezionare un cursore e specificare una descrizione comandi.

class CMFCButton : public CButton

Membri

Costruttori pubblici

Nome	Descrizione
CMFCButton::CMFCButton	Costruttore predefinito.
CMFCButton::~CMFCButton	Distruttore

Metodi pubblici

Nome	Descrizione
CMFCButton::CleanUp	Reimposta le variabili interne e libera le risorse allocate ad esempio immagini, bitmap e icone.
CMFCButton::CreateObject	Utilizzato dal framework di creare un'istanza dinamica di questo tipo della classe.
CMFCButton::DrawItem	Chiamato dal framework quando un aspetto visivo di un pulsante creato dal proprietario è stato modificato.(Override CButton::DrawItem).
CMFCButton::EnableFullTextTooltip	Specifica se visualizzare il testo completo di una descrizione comandi in una grande descrizione comandi o una versione tronca di testo in una breve descrizione comandi.
CMFCButton::EnableMenuFont	Specifica se il tipo di carattere del testo del pulsante è la stessa di carattere del menu di un'applicazione.
CMFCButton::EnableWindowsTheming	Specifica se lo stile del bordo del pulsante corrisponde al tema corrente di Windows.
CMFCButton::GetThisClass	Utilizzato dal framework per ottenere un puntatore all'oggetto CRuntimeClass associato a questo tipo della classe.
CMFCButton::GetToolTipCtrl	Restituisce un riferimento al controllo sottostante di descrizione comandi.
CMFCButton::IsAutoCheck	Indica se una casella di controllo o un pulsante di opzione è un pulsante automatico.
CMFCButton::IsAutorepeatCommandMode	Indica se un pulsante viene impostato sulla modalità automatica di ripetizione.
CMFCButton::IsCheckBox	Indica se un pulsante è un pulsante della casella di controllo.
CMFCButton::IsChecked	Indica se il pulsante corrente viene controllato.
CMFCButton::IsHighlighted	Indica se un pulsante è evidenziato.
CMFCButton::IsPressed	Indica se un pulsante viene premuto e evidenziato.
CMFCButton::IsPushed	Indica se un pulsante viene premuto.
CMFCButton::IsRadioButton	Indica se un pulsante è un pulsante di opzione.
CMFCButton::IsWindowsThemingEnabled	Indica se lo stile del bordo del pulsante corrisponde al tema corrente di Windows.
CMFCButton::OnDrawParentBackground	Consente di disegnare lo sfondo del padre di un pulsante nell'area specificata.(Override AFX_GLOBAL_DATA::DrawParentBackground).
CMFCButton::PreTranslateMessage	Converte i messaggi della finestra prima che vengano inviati alle funzioni Windows DispatchMessage e TranslateMessage.(Override CWnd::PreTranslateMessage).
CMFCButton::SetAutorepeatMode	Imposta un pulsante in modalità automatica di ripetizione.
CMFCButton::SetCheckedImage	L'immagine di un pulsante selezionato.
CMFCButton::SetFaceColor	Imposta il colore di sfondo del testo del pulsante.
CMFCButton::SetImage	L'immagine di un pulsante.
CMFCButton::SetMouseCursor	L'immagine del cursore.
CMFCButton::SetMouseCursorHand	Imposta il cursore all'immagine di una mano.
CMFCButton::SetStdImage	Utilizza un oggetto CMenuImages per impostare l'immagine del pulsante.
CMFCButton::SetTextColor	Imposta il colore del testo del pulsante per un pulsante non selezionato.
CMFCButton::SetTextHotColor	Imposta il colore del testo del pulsante per un pulsante selezionato.
CMFCButton::SetTooltip	Associa una descrizione comando con un pulsante.
CMFCButton::SizeToContent	Viene ridimensionato un pulsante per contenere il testo del pulsante e immagine.

Metodi protetti

Nome	Descrizione
CMFCButton::OnDraw	Chiamato dal framework per disegnare un pulsante.
CMFCButton::OnDrawBorder	Chiamato dal framework per disegnare il bordo di un pulsante.
CMFCButton::OnDrawFocusRect	Chiamato dal framework per disegnare un rettangolo di attivazione per un pulsante.
CMFCButton::OnDrawText	Chiamato dal framework per creare il testo del pulsante.
CMFCButton::OnFillBackground	Chiamato dal framework per disegnare lo sfondo del testo del pulsante.
CMFCButton::SelectFont	Recupera il carattere associata al contesto di dispositivo specificato.

Membri di dati

Nome	Descrizione
CMFCButton::m_bDrawFocus	Indica se disegnare un rettangolo di attivazione intorno al pulsante.
CMFCButton::m_bHighlightChecked	Indica se evidenziare un BS_CHECKBOX-style il pulsante quando il cursore si sposta su.
CMFCButton::m_bRightImage	Indica se visualizzare un'immagine a destra del pulsante.
CMFCButton::m_bTransparent	Indica se il pulsante è transparent.
CMFCButton::m_nAlignStyle	Specifica l'allineamento del testo del pulsante.
CMFCButton::m_nFlatStyle	Specifica lo stile del pulsante, come senza frontiere, piano, semi- piano, o tridimensionale.

Note

Altri tipi di pulsanti sono derivati dalla classe CMFCButton, come la classe CMFCURLLinkButton, che supporta i collegamenti ipertestuali e la classe CMFCColorButton, che supporta una finestra di dialogo di selezione colori.

Lo stile di un oggetto CMFCButton può essere tridimensionale, piano, semi- piano o nessun bordo.Il testo del pulsante può essere allineato il sinistro, superiore, o al centro di un pulsante.In fase di esecuzione, è possibile determinare se le visualizzazioni del pulsante l'utente immette un testo, un'immagine, o testo e un'immagine.È anche possibile specificare che una particolare immagine del cursore visualizzato quando il cursore si sposta su un pulsante.

Creare un pulsante direttamente nel codice, oppure utilizzando lo strumento Creazione guidata classe MFC e un modello di finestra di dialogo.Se si crea direttamente un pulsante, aggiungere una variabile CMFCButton all'applicazione e quindi chiamare il costruttore e i metodi CreateCMFCButton oggetto.Se si utilizza Creazione guidata classe MFC, aggiungere una variabile CButton all'applicazione e modificare il tipo di variabile da CButton a CMFCButton.

Per gestire i messaggi di notifica in un'applicazione della finestra di dialogo, aggiungere una voce della mappa messaggi e un gestore eventi per ogni notifica.Le notifiche inviate da un oggetto CMFCButton sono uguali a quelle inviate da un oggetto CButton.

Esempio

Nell'esempio seguente viene illustrato come configurare le proprietà del pulsante utilizzando i diversi metodi nella classe CMFCButton.l'esempio fa parte Nuovo esempio di controlli.

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