Classe di CMFCToolBarButton

Articolo
02/19/2013

Fornisce la funzionalità del pulsante le barre degli strumenti.

class CMFCToolBarButton : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CMFCToolBarButton::CMFCToolBarButton	Costrutti e inizializza un oggetto CMFCToolBarButton.
CMFCToolBarButton::~CMFCToolBarButton	Distruttore

Metodi pubblici

Nome	Descrizione
CMFCToolBarButton::CanBeDropped	Specifica se un utente può inserire un pulsante di una barra degli strumenti o il menu durante la personalizzazione.
CMFCToolBarButton::CanBeStored	Specifica se il pulsante può essere archiviato.
CMFCToolBarButton::CanBeStretched	Specifica se un utente può contenere il pulsante durante la personalizzazione.
CMFCToolBarButton::CompareWith	Confronta questa istanza di con l'oggetto specificato CMFCToolBarButton.
CMFCToolBarButton::CopyFrom	Copiare le proprietà di un altro pulsante della barra degli strumenti al pulsante corrente.
CMFCToolBarButton::CreateFromOleData	Crea un oggetto CMFCToolBarButton dall'oggetto fornito COleDataObject.
CMFCToolBarButton::CreateObject	Utilizzato dal framework di creare un'istanza dinamica di questo tipo della classe.
CMFCToolBarButton::EnableWindow	Abilita o disabilita il mouse e l'input della tastiera.
CMFCToolBarButton::ExportToMenuButton	Le copie il testo del pulsante della barra degli strumenti a un menu.
CMFCToolBarButton::GetClipboardFormat	Recupera il formato degli Appunti globale per l'applicazione.
CMFCToolBarButton::GetHwnd	Recupera l'handle della finestra associata al pulsante della barra degli strumenti.
CMFCToolBarButton::GetImage	Recupera l'indice di immagine del pulsante.
CMFCToolBarButton::GetInvalidateRect	Recupera l'area dell'area client del pulsante da ridisegnare.
CMFCToolBarButton::GetParentWnd	Recupera la finestra padre del pulsante.
CMFCToolBarButton::GetProtectedCommands	Recupera l'elenco dei controlli che l'utente non può personalizzare.
CMFCToolBarButton::GetTextSize	Recupera la dimensione del testo del pulsante.
CMFCToolBarButton::HasFocus	Determina se il pulsante presenta lo stato attivo per l'input corrente.
CMFCToolBarButton::HaveHotBorder	Determina se un bordo del pulsante viene visualizzato quando un utente seleziona il pulsante.
CMFCToolBarButton::IsDrawImage	Determina se un'immagine viene visualizzato sul pulsante.
CMFCToolBarButton::IsDrawText	Determina se un'etichetta di testo viene visualizzato sul pulsante.
CMFCToolBarButton::IsDroppedDown	Determina se il pulsante viene visualizzato un sottomenu.
CMFCToolBarButton::IsEditable	Determina se il pulsante può essere personalizzato.
CMFCToolBarButton::IsExtraSize	Determina se il pulsante può essere visualizzata con un bordo esteso.
CMFCToolBarButton::IsFirstInGroup	Determina se il pulsante nella prima posizione nel gruppo di pulsanti.
CMFCToolBarButton::IsHidden	Determina se il pulsante è nascosto.
CMFCToolBarButton::IsHorizontal	Determina se il pulsante si trova in una barra degli strumenti orizzontale.
CMFCToolBarButton::IsLastInGroup	Specifica se il pulsante è nell'ultima posizione nel gruppo di pulsanti.
CMFCToolBarButton::IsLocked	Determina se il pulsante in una barra degli strumenti personalizzabile (non) bloccata.
CMFCToolBarButton::IsOwnerOf	Determina se il pulsante è il proprietario di handle della finestra fornito.
CMFCToolBarButton::IsVisible	Determina se il pulsante nella barra degli strumenti è visibile.
CMFCToolBarButton::IsWindowVisible	Determina se l'handle della finestra sottostanti del pulsante sono visibili.
CMFCToolBarButton::NotifyCommand	Specifica se il pulsante elabora il messaggio WM_COMMAND.
CMFCToolBarButton::OnAddToCustomizePage	Chiamato dal framework quando il pulsante viene aggiunto a una finestra di dialogo Personalizza.
CMFCToolBarButton::OnBeforeDrag	Specifica se il pulsante è possibile trascinare.
CMFCToolBarButton::OnBeforeDrop	Specifica se un utente può rilasciare il pulsante della barra degli strumenti di destinazione.
CMFCToolBarButton::OnCalculateSize	Chiamato dal framework per calcolare la dimensione del pulsante per lo stato specificato di ancoraggio e di contesto di dispositivo.
CMFCToolBarButton::OnCancelMode	Chiamato dal framework per gestire il messaggio WM_CANCELMODE.
CMFCToolBarButton::OnChangeParentWnd	Chiamato dal framework quando il pulsante viene inserito in una nuova barra degli strumenti.
CMFCToolBarButton::OnClick	Chiamato dal framework quando l'utente fa clic sul pulsante del mouse.
CMFCToolBarButton::OnClickUp	Chiamato dal framework quando l'utente rilascia il pulsante del mouse.
CMFCToolBarButton::OnContextHelp	Chiamato dal framework quando la barra degli strumenti padre gestisce un messaggio WM_HELPHITTEST.
CMFCToolBarButton::OnCtlColor	Chiamato dal framework quando la barra degli strumenti padre gestisce un messaggio WM_CTLCOLOR.
CMFCToolBarButton::OnCustomizeMenu	Consente del pulsante modificare il menu fornito quando l'applicazione visualizza un menu di scelta rapida nella barra degli strumenti padre.
CMFCToolBarButton::OnDblClk	Chiamato dal framework quando la barra degli strumenti padre gestisce un messaggio WM_LBUTTONDBLCLK.
CMFCToolBarButton::OnDraw	Chiamato dal framework per disegnare il pulsante utilizzando gli stili e le opzioni specificate.
CMFCToolBarButton::OnDrawOnCustomizeList	Chiamato dal framework per disegnare il pulsante nel riquadro Comandi la finestra di dialogo Personalizza.
CMFCToolBarButton::OnGetCustomToolTipText	Chiamato dal framework per recuperare il testo personalizzato di descrizione comando per il pulsante.
CMFCToolBarButton::OnGlobalFontsChanged	Chiamato dal framework quando il tipo globale è stato modificato.
CMFCToolBarButton::OnMove	Chiamato dal framework quando la barra degli strumenti padre viene spostato.
CMFCToolBarButton::OnShow	Chiamato dal framework quando il pulsante diventa visibile o invisibile.
CMFCToolBarButton::OnSize	Chiamato dal framework quando la barra degli strumenti padre viene modificato la dimensione o la posizione e questa modifica richiede il pulsante di modificare le dimensioni.
CMFCToolBarButton::OnToolHitTest	Chiamato dal framework quando la barra degli strumenti padre deve determinare se un punto si trova nel rettangolo di delimitazione del pulsante.
CMFCToolBarButton::OnUpdateToolTip	Chiamato dal framework quando la barra degli strumenti padre aggiorna il testo di descrizione comando.
CMFCToolBarButton::PrepareDrag	Chiamato dal framework quando il pulsante sta per eseguire un'operazione di trascinamento.
CMFCToolBarButton::Rect	Recupera il rettangolo di delimitazione del pulsante.
CMFCToolBarButton::ResetImageToDefault	Imposta il valore predefinito l'immagine associata al pulsante.
CMFCToolBarButton::SaveBarState	Salvare lo stato del pulsante della barra degli strumenti.
CMFCToolBarButton::Serialize	Legge l'oggetto da un archivio o scritto in un archivio.(Override CObject::Serialize).
CMFCToolBarButton::SetACCData	Popola l'oggetto fornito CAccessibilityData con i dati di accessibilità il pulsante della barra degli strumenti.
CMFCToolBarButton::SetClipboardFormatName	Rinomina il formato degli Appunti globale.
CMFCToolBarButton::SetImage	Imposta l'indice di immagine del pulsante.
CMFCToolBarButton::SetProtectedCommands	Imposta l'elenco di controlli che l'utente non può personalizzare.
CMFCToolBarButton::SetRadio	Chiamato dal framework quando un pulsante cambia lo stato di selezione.
CMFCToolBarButton::SetRect	Imposta il rettangolo di delimitazione del pulsante.
CMFCToolBarButton::SetStyle	Imposta lo stile del pulsante.
CMFCToolBarButton::SetVisible	Specifica se il pulsante è visibile.
CMFCToolBarButton::Show	Mostra o nasconde il pulsante.

Membri di dati

Nome	Descrizione
CMFCToolBarButton::m_bImage	Specifica se un'immagine viene visualizzato sul pulsante.
CMFCToolBarButton::m_bText	Specifica se un'etichetta di testo viene visualizzato sul pulsante.
CMFCToolBarButton::m_bTextBelow	Specifica se l'etichetta di testo visualizzato al di sotto dell'immagine sul pulsante.
CMFCToolBarButton::m_bUserButton	Specifica se il pulsante è un'immagine definita dall'utente.
CMFCToolBarButton::m_bWholeText	Specifica se il pulsante visualizza un'etichetta full-text anche se non rientra nel rettangolo di delimitazione.
CMFCToolBarButton::m_bWrap	Specifica se il pulsante accanto a un separatore verrà inserito nella riga successiva.
CMFCToolBarButton::m_bWrapText	Specifica se le etichette di testo su più righe sono abilitate.
CMFCToolBarButton::m_nID	L'id di comando del pulsante.
CMFCToolBarButton::m_nStyle	Lo stile del pulsante.
CMFCToolBarButton::m_strText	L'etichetta di testo del pulsante.

Note

Un oggetto CMFCToolbarButton è un controllo che si trova in una barra degli strumenti.Il comportamento simile a quello di un pulsante.È possibile assegnare un'immagine e un'etichetta di testo a questo oggetto.Un pulsante della barra degli strumenti può essere un ID di comandoQuando l'utente fa clic sul pulsante della barra degli strumenti, il framework esegue il comando che questo ID specifica.

In genere, i pulsanti della barra degli strumenti possono essere personalizzati: l'utente può trascinare i pulsanti di una barra degli strumenti a un'altra e copia, incolla, eliminare e modificare le etichette di testo e le immagini.Per impedire all'utente di personalizzare la barra degli strumenti, è possibile bloccare la barra degli strumenti in due modi.O imposta il flag bLocked a TRUE quando si chiama CMFCToolBar::LoadToolBar, o aggiungere l'id di comando di un pulsante all'elenco globale dei controlli protetti tramite il metodo CMFCToolBarButton::SetProtectedCommands.

CMFCToolBarButton oggetti e le immagini dalle raccolte globali di immagini della barra degli strumenti nell'applicazione.Queste raccolte vengono gestite dalla barra degli strumenti padre, Classe di CMFCToolBar.Per ulteriori informazioni, vedere Classe di CMFCToolBarImages.

Quando l'utente fa clic su un pulsante della barra degli strumenti, la barra degli strumenti padre elabora il messaggio del mouse e passa le azioni appropriate al pulsante.Se il pulsante è un ID di comando valido, la barra degli strumenti padre invia il messaggio WM_COMMAND al frame padre.

La classe CMFCToolBarButton è la classe base per altre classi del pulsante della barra degli strumenti, come Classe di CMFCToolBarMenuButton, Classe di CMFCToolBarEditBoxButtone Classe di CMFCToolBarComboBoxButton.

Esempio

Nell'esempio seguente viene illustrato come configurare un oggetto CMFCToolBarButton utilizzando i diversi metodi nella classe CMFCToolBarButton.Nell'esempio viene illustrato come abilitare il mouse e l'input della tastiera, impostare il contenuto di immagine del pulsante, impostare il rettangolo di delimitazione del pulsante e rendere visibile il pulsante.Questo frammento di codice fa parte Esempio di controllo tab.

    CMFCToolBarButton* pOffice2007 = NULL;
    int nIndex = -1;
    
    for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
    {
        // CMFCToolBar  m_wndToolBarTheme
        nIndex = m_wndToolBarTheme.CommandToIndex (uiCmd);

        CMFCToolBarButton* pButton = m_wndToolBarTheme.GetButton (nIndex);
    
        if (pButton != NULL)
        {
            pOffice2007 = pButton;
            break;
        }
    }


...


    pOffice2007->EnableWindow();
    pOffice2007->SetImage(1);
    pOffice2007->SetRect( CRect(1,1,1,1));
    pOffice2007->SetVisible();
    pOffice2007->Show(true);