Classe CMFCToolBar

Articolo
06/10/2015

La classe CMFCToolBar simile a Classe CToolBar, ma fornisce supporto aggiuntivo per le funzionalità dell'interfaccia utente. Questi includono barre degli strumenti piane, barre degli strumenti con le calde immagini, icone grandi, i pulsanti del componente di spostamento, barre degli strumenti bloccate, i controlli Rebar, il testo nelle immagini, le immagini di sfondo e barre degli strumenti a schede. La classe CMFCToolBar contiene inoltre il supporto incorporato per la personalizzazione dell'utente delle barre degli strumenti e dei menu, il trascinamento della selezione tra le barre degli strumenti e menu, pulsanti della casella combinata, i pulsanti della casella di modifica, selezionare i colori e i pulsanti di rollup.

class CMFCToolBar : public CMFCBaseToolBar

Membri

Costruttori pubblici

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

Metodi pubblici

Nome	Descrizione
CMFCToolBar::AddBasicCommand	Aggiunge un comando di menu all'elenco dei controlli che visualizzano sempre quando un utente apre un menu.
CMFCToolBar::AddCommandUsage	Incrementa di uno il contatore associato al comando specificato.
CMFCToolBar::AddToolBarForImageCollection	Aggiungere le immagini alle risorse di interfaccia utente alla raccolta di immagini nell'applicazione.
CMFCToolBar::AdjustLayout	Ricalcola la dimensione e la posizione di una barra degli strumenti. (Esegue l'override di CBasePane::AdjustLayout).
CMFCToolBar::AdjustSize	Ricalcola la dimensione della barra degli strumenti.
CMFCToolBar::AllowChangeTextLabels	Specifica se le etichette di testo possono essere visualizzate sotto le immagini sui pulsanti della barra degli strumenti.
CMFCToolBar::AreTextLabels	Specifica se le etichette di testo nelle immagini attualmente visualizzati i pulsanti della barra degli strumenti.
CMFCToolBar::AutoGrayInactiveImages	Abilitare o disabilitare la generazione automatica di immagini del pulsante inattive.
CMFCToolBar::ButtonToIndex	Restituisce l'indice di un determinato oggetto Classe CMFCToolBarButton in questa barra degli strumenti.
CMFCToolBar::CalcFixedLayout	Calcola la dimensione orizzontale della barra degli strumenti. (Override CBasePane::CalcFixedLayout).
CMFCToolBar::CalcSize	Chiamato dal framework durante il processo di calcolo del layout. (Override CPane::CalcSize).
CMFCToolBar::CanHandleSiblings	Determina se la barra degli strumenti e il relativo elemento di pari livello vengono inseriti nello stesso riquadro.
CMFCToolBar::CleanUpImages	Libera le risorse di sistema allocate per le immagini della barra degli strumenti.
CMFCToolBar::CleanUpLockedImages	Libera le risorse di sistema allocate per le immagini bloccate della barra degli strumenti.
CMFCToolBar::CanBeClosed	Specifica se un utente può chiudere la barra degli strumenti. (Override CBasePane::CanBeClosed).
CMFCToolBar::CanBeRestored	Determina se il sistema è in grado di ripristinare una barra degli strumenti allo stato originale dopo la personalizzazione.
CMFCToolBar::CanFocus	Specifica se il riquadro può ricevere lo stato attivo. (Override CBasePane::CanFocus).
CMFCToolBar::CanHandleSiblings	Determina se la barra degli strumenti e il relativo elemento di pari livello vengono inseriti nello stesso riquadro.
CMFCToolBar::CommandToIndex	Restituisce l'indice del pulsante nella barra degli strumenti con un ID di comando
CMFCToolBar::Create	Crea un oggetto CMFCToolBar.
CMFCToolBar::CreateEx	Crea un oggetto CMFCToolBar utilizzando le opzioni di stile aggiuntive, come icone grandi.
CMFCToolBar::Deactivate	Disattiva la barra degli strumenti.
CMFCToolBar::EnableCustomizeButton	Abilita o disabilita il pulsante Aggiungi o rimuovi pulsanti visualizzato alle estremità della barra degli strumenti.
CMFCToolBar::EnableDocking	Consente l'ancoraggio del riquadro della cornice principale. (Override CBasePane::EnableDocking).
CMFCToolBar::EnableLargeIcons	Abilita o disabilita icone grandi sui pulsanti della barra degli strumenti.
CMFCToolBar::EnableQuickCustomization	Abilita o disabilita la personalizzazione delle barre degli strumenti per consentire il tasto ALT e trascinare l'utente un pulsante in una nuova posizione.
CMFCToolBar::EnableReflections	Abilita o disabilita la reflection di comando.
CMFCToolBar::EnableTextLabels	Abilita o disabilita le etichette di testo sotto le icone dei pulsanti della barra degli strumenti.
CMFCToolBar::FromHandlePermanent	Recupera un puntatore all'oggetto CMFCToolBar che contiene l'handle della finestra specificato.
CMFCToolBar::GetAllButtons	Restituisce un elenco di sola lettura dei pulsanti di una barra degli strumenti.
CMFCToolBar::GetAllToolbars	Restituisce un elenco di sola lettura di tutte le barre degli strumenti nell'applicazione.
CMFCToolBar::GetBasicCommands	Restituisce un elenco di sola lettura dei comandi di base definiti nell'applicazione.
CMFCToolBar::GetButton	Restituisce un puntatore a un oggetto CMFCToolBarButton con indice specificato del pulsante della barra degli strumenti.
CMFCToolBar::GetButtonInfo	Restituisce l'id di comando, lo stile e l'indice di un'immagine del pulsante a un indice specificato.
CMFCToolBar::GetButtonSize	Restituisce le dimensioni di ciascun pulsante sulla barra degli strumenti.
CMFCToolBar::GetButtonStyle	Restituisce lo stile corrente del pulsante della barra degli strumenti che si trova all'indice specificato.
CMFCToolBar::GetButtonText	Restituisce l'etichetta di testo di un pulsante con indice specificato.
CMFCToolBar::GetColdImages	Restituisce un puntatore alla raccolta di immagini fredde del pulsante della barra degli strumenti nell'applicazione.
CMFCToolBar::GetColumnWidth	Restituisce la larghezza dei pulsanti della barra degli strumenti.
CMFCToolBar::GetCommandButtons	Restituisce un elenco dei pulsanti con un ID di comando specificato da tutte le barre degli strumenti nell'applicazione.
CMFCToolBar::GetCount	Restituisce il numero di pulsanti e dei separatori nella barra degli strumenti.
CMFCToolBar::GetCustomizeButton	Recupera un puntatore all'oggetto CMFCCustomizeButton associato alla barra degli strumenti.
CMFCToolBar::GetDefaultImage	Restituisce l'indice dell'immagine predefinita per un pulsante della barra degli strumenti con un ID di comando
CMFCToolBar::GetDisabledImages	Restituisce un puntatore alla raccolta di immagini utilizzate per i pulsanti della barra degli strumenti disabilitati nell'applicazione.
CMFCToolBar::GetDisabledMenuImages	Restituisce un puntatore alla raccolta di immagini utilizzate per i pulsanti disabilitati del menu nell'applicazione.
CMFCToolBar::GetDroppedDownMenu	Recupera un puntatore all'oggetto del pulsante del menu visualizzato correntemente il sottomenu.
CMFCToolBar::GetGrayDisabledButtons	Specifica se le immagini dei pulsanti disabilitati vengono visualizzate in grigio versioni delle icone dei pulsanti normali, o accettato dalla libreria di immagini del pulsante disabilitate.
CMFCToolBar::GetHighlightedButton	Restituisce un puntatore al pulsante della barra degli strumenti attualmente è evidenziato.
CMFCToolBar::GetHotBorder	Determina se i pulsanti della barra degli strumenti caldo- vengono registrati.
CMFCToolBar::GetHotTextColor	Restituisce il colore del testo dei pulsanti della barra degli strumenti evidenziati.
CMFCToolBar::GetHwndLastFocus	Restituisce un handle di finestra che aveva lo stato attivo per l'input prima della barra degli strumenti è stata effettuata.
CMFCToolBar::GetIgnoreSetText	Specifica se le chiamate alle etichette impostare il pulsante vengono ignorate.
CMFCToolBar::GetImageSize	Restituisce le dimensioni correnti delle icone dei pulsanti della barra degli strumenti.
CMFCToolBar::GetImages	Restituisce un puntatore alla libreria di immagini del pulsante predefinito dell'applicazione.
CMFCToolBar::GetImagesOffset	Restituisce l'offset dell'indice utilizzato per trovare immagini del pulsante della barra degli strumenti per questa barra degli strumenti nell'elenco globale delle icone dei pulsanti della barra degli strumenti.
CMFCToolBar::GetInvalidateItemRect	Recupera l'area dell'area client da ridisegnare per il pulsante all'indice specificato.
CMFCToolBar::GetItemID	Restituisce l'id di comando del pulsante della barra degli strumenti a un indice specificato.
CMFCToolBar::GetItemRect	Restituisce il rettangolo di delimitazione del pulsante a un indice specificato.
CMFCToolBar::GetLargeColdImages	Restituisce un puntatore alla libreria di immagini di grandi dimensioni fredde del pulsante della barra degli strumenti nell'applicazione.
CMFCToolBar::GetLargeDisabledImages	Restituisce un puntatore alla libreria di immagini di grandi dimensioni disabilitate del pulsante della barra degli strumenti nell'applicazione.
CMFCToolBar::GetLargeImages	Restituisce un puntatore alla libreria di immagini di grandi dimensioni del pulsante della barra degli strumenti nell'applicazione.
CMFCToolBar::GetLockedColdImages	Restituisce un puntatore alla raccolta di immagini fredde bloccate la barra degli strumenti.
CMFCToolBar::GetLockedDisabledImages	Restituisce un puntatore alla raccolta di immagini disabilitate bloccate la barra degli strumenti.
CMFCToolBar::GetLockedImages	Restituisce un puntatore alla libreria di immagini del pulsante bloccate la barra degli strumenti.
CMFCToolBar::GetLockedImageSize	Restituisce la dimensione predefinita di immagini bloccate della barra degli strumenti.
CMFCToolBar::GetLockedMenuImages	Restituisce un puntatore alla raccolta di immagini bloccate il menu della barra degli strumenti nella barra degli strumenti.
CMFCToolBar::GetMenuButtonSize	Restituisce le dimensioni dei pulsanti di menu nell'applicazione.
CMFCToolBar::GetMenuImageSize	Restituisce le dimensioni delle immagini del pulsante del menu nell'applicazione.
CMFCToolBar::GetMenuImages	Restituisce un puntatore alla libreria di immagini del pulsante del menu nell'applicazione.
CMFCToolBar::GetOrigButtons	Recupera la raccolta di pulsanti non personalizzati della barra degli strumenti.
CMFCToolBar::GetOrigResetButtons	Recupera la raccolta di pulsanti di reimpostazione automatica non personalizzati della barra degli strumenti.
CMFCToolBar::GetResourceID	Recupera gli ID di risorsa della barra degli strumenti.
CMFCToolBar::GetRouteCommandsViaFrame	Determina quale oggetto, il frame padre o il proprietario, invia i controlli della barra degli strumenti.
CMFCToolBar::GetRowHeight	Restituisce l'altezza dei pulsanti della barra degli strumenti.
CMFCToolBar::GetShowTooltips	Specifica se le descrizioni comandi visualizzati per i pulsanti della barra degli strumenti.
CMFCToolBar::GetSiblingToolBar	Recupera l'elemento di pari livello della barra degli strumenti.
CMFCToolBar::GetUserImages	Restituisce un puntatore alla raccolta di immagini definite dall'utente del pulsante della barra degli strumenti nell'applicazione.
CMFCToolBar::HitTest	Restituisce l'indice del pulsante della barra degli strumenti che si trova nella posizione specificata.
CMFCToolBar::InsertButton	Inserisce un pulsante nella barra degli strumenti.
CMFCToolBar::InsertSeparator	Inserisce un separatore la barra degli strumenti.
CMFCToolBar::InvalidateButton	Invalida l'area client del pulsante della barra degli strumenti che esiste all'indice specificato.
CMFCToolBar::IsAddRemoveQuickCustomize	Determina se un utente può aggiungere o rimuovere pulsanti della barra degli strumenti mediante l'opzione di menu Personalizza.
CMFCToolBar::IsAltCustomizeMode	Specifica se la personalizzazione rapida viene utilizzata per trascinare un pulsante.
CMFCToolBar::IsAutoGrayInactiveImages	Specifica se la generazione automatica di immagini del pulsante (non evidenziate) inattive è abilitata.
CMFCToolBar::IsBasicCommand	Determina se un comando consiste nell'elenco di comandi di base.
CMFCToolBar::IsButtonExtraSizeAvailable	Determina se la barra degli strumenti può visualizzare i pulsanti che hanno esteso i bordi.
CMFCToolBar::IsButtonHighlighted	Determina se il pulsante nella barra degli strumenti è evidenziato.
CMFCToolBar::IsCommandPermitted	Determina se il comando è consentito.
CMFCToolBar::IsCommandRarelyUsed	Determina se un comando viene utilizzata raramente (vedere CMFCToolBar::SetCommandUsageOptions).
CMFCToolBar::IsCustomizeMode	Specifica se il framework della barra degli strumenti è in modalità di personalizzazione.
CMFCToolBar::IsDragButton	Determina se un pulsante della barra degli strumenti sta trascinando.
CMFCToolBar::IsExistCustomizeButton	Determina se la barra degli strumenti contiene il pulsante Personalizza.
CMFCToolBar::IsFloating	Determina se la barra degli strumenti è mobile.
CMFCToolBar::IsLargeIcons	Specifica se barre degli strumenti icone della visualizzazione dell'applicazione attualmente nelle dimensioni maggiori.
CMFCToolBar::IsLastCommandFromButton	Determina se il comando recentemente effettuato è stato inviato dal pulsante della barra degli strumenti specificato.
CMFCToolBar::IsLocked	Determina se la barra degli strumenti è bloccata.
CMFCToolBar::IsOneRowWithSibling	Determina se la barra degli strumenti e la barra degli strumenti di pari livello vengono collocati sulla stessa riga.
CMFCToolBar::IsUserDefined	Specifica se la barra degli strumenti è definita dall'utente.
CMFCToolBar::LoadBitmap	Carica le immagini della barra degli strumenti dalle risorse dell'applicazione.
CMFCToolBar::LoadBitmapEx	Carica le immagini della barra degli strumenti dalle risorse dell'applicazione. Include le immagini di grandi dimensioni.
CMFCToolBar::LoadParameters	Carica le opzioni globali della barra degli strumenti di Windows Registro di sistema.
CMFCToolBar::LoadState	Carica le informazioni sullo stato della barra degli strumenti di Windows Registro di sistema. (Override CPane::LoadState).
CMFCToolBar::LoadToolBar	Caricamento della barra degli strumenti dalle risorse dell'applicazione.
CMFCToolBar::LoadToolBarEx	Caricamento della barra degli strumenti dalle risorse dell'applicazione utilizzando la classe di supporto CMFCToolBarInfo per attivare l'applicazione per l'utilizzo di immagini di grandi dimensioni.
CMFCToolBar::OnChangeHot	Chiamato dal framework quando un utente seleziona un pulsante nella barra degli strumenti.
CMFCToolBar::OnFillBackground	Chiamato dal framework da CBasePane::DoPaint per riempire lo sfondo della barra degli strumenti.
CMFCToolBar::OnReset	Ripristina la barra degli strumenti allo stato originale.
CMFCToolBar::OnSetAccData	(Override CBasePane::OnSetAccData).
CMFCToolBar::OnSetDefaultButtonText	Ripristina il testo di un pulsante della barra degli strumenti allo stato predefinito.
CMFCToolBar::OnUpdateCmdUI	Per uso interno.
CMFCToolBar::RemoveAllButtons	Rimuove tutti i pulsanti della barra.
CMFCToolBar::RemoveButton	Rimuove il pulsante all'indice specificato dalla barra degli strumenti.
CMFCToolBar::RemoveStateFromRegistry	Elimina le informazioni sullo stato della barra degli strumenti di Windows Registro di sistema.
CMFCToolBar::ReplaceButton	Sostituisce un pulsante della barra degli strumenti con un altro pulsante della barra degli strumenti.
CMFCToolBar::ResetAll	Ripristina tutte le barre degli strumenti agli stati originali.
CMFCToolBar::ResetAllImages	Rimuove tutte le raccolte di immagine della barra degli strumenti nell'applicazione.
CMFCToolBar::RestoreOriginalstate	Ripristina lo stato originale di una barra degli strumenti.
CMFCToolBar::SaveState	Salva le informazioni sullo stato della barra degli strumenti in Windows Registro di sistema. (Override CPane::SaveState).
CMFCToolBar::Serialize	(Override CBasePane::Serialize).
CMFCToolBar::SetBasicCommands	Imposta l'elenco di controlli che visualizzano sempre quando un utente apre un menu.
CMFCToolBar::SetButtonInfo	Impostare l'id di comando, lo stile e l'immagine ID di un pulsante della barra degli strumenti.
CMFCToolBar::SetButtonStyle	Imposta lo stile del pulsante della barra degli strumenti all'indice specificato.
CMFCToolBar::SetButtonText	Impostare l'etichetta di testo di un pulsante della barra degli strumenti.
CMFCToolBar::SetButtons	Imposta i pulsanti della barra degli strumenti.
CMFCToolBar::SetCommandUsageOptions	Specifica quando i controlli raramente utilizzati non vengono visualizzati nel menu dell'applicazione.
CMFCToolBar::SetCustomizeMode	Abilita o disabilita la modalità di personalizzazione delle barre degli strumenti nell'applicazione.
CMFCToolBar::SetGrayDisabledButtons	Specifica se i pulsanti disabilitati nella barra degli strumenti sono attenuati o se le immagini disabilitate vengono utilizzate per i pulsanti disabilitati.
CMFCToolBar::SetHeight	L'altezza della barra degli strumenti.
CMFCToolBar::SetHotBorder	Specifica se i pulsanti della barra degli strumenti caldo- vengono registrati.
CMFCToolBar::SetHotTextColor	Imposta il colore del testo per i pulsanti della barra degli strumenti caldi.
CMFCToolBar::SetLargeIcons	Specifica se i pulsanti della barra degli strumenti visualizzare icone grandi.
CMFCToolBar::SetLockedSizes	Impostare le dimensioni dei pulsanti bloccati e immagini bloccate sulla barra degli strumenti.
CMFCToolBar::SetMenuSizes	Imposta la dimensione dei pulsanti di menu della barra degli strumenti e le immagini.
CMFCToolBar::SetNonPermittedCommands	Imposta l'elenco di controlli che non possono essere eseguiti dall'utente.
CMFCToolBar::SetOneRowWithSibling	Posiziona la barra degli strumenti e il relativo elemento di pari livello agli stessi righe.
CMFCToolBar::SetPermament	Specifica se un utente può chiudere la barra degli strumenti.
CMFCToolBar::SetRouteCommandsViaFrame	Specifica se il frame padre o il proprietario invia i controlli della barra degli strumenti.
CMFCToolBar::SetShowTooltips	Specifica se il framework di visualizzare le descrizioni comandi.
CMFCToolBar::SetSiblingToolBar	Specifica l'elemento di pari livello della barra degli strumenti.
CMFCToolBar::SetSizes	Specifica le dimensioni dei pulsanti e le immagini sulle barre degli strumenti.
CMFCToolBar::SetToolBarBtnText	Specifica le proprietà di un pulsante nella barra degli strumenti.
CMFCToolBar::SetTwoRowsWithSibling	Posiziona la barra degli strumenti e il relativo elemento di pari livello su righe separate.
CMFCToolBar::SetUserImages	Imposta la raccolta di immagini definite dall'applicazione.
CMFCToolBar::StretchPane	Corretta la barra degli strumenti verticale o orizzontale. (Override CBasePane::StretchPane).
CMFCToolBar::TranslateChar	Esegue un comando pulsante se il codice tasto specificato corrisponde a una scelta rapida valida.
CMFCToolBar::UpdateButton	Aggiorna lo stato del pulsante specificato.
CMFCToolBar::WrapToolBar	Riposizionamento dei pulsanti della barra degli strumenti nelle dimensioni specificate.

Metodi protetti

Nome	Descrizione
CMFCToolBar::AllowShowOnList	Determina se la barra degli strumenti nell'elenco viene visualizzata nel riquadro Barre degli strumenti la finestra di dialogo Personalizza.
CMFCToolBar::CalcMaxButtonHeight	Calcola l'altezza massima di un pulsante nella barra degli strumenti.
CMFCToolBar::DoPaint	Aggiorna una barra degli strumenti.
CMFCToolBar::DrawButton	Aggiorna un pulsante della barra degli strumenti.
CMFCToolBar::DrawSeparator	Aggiorna un separatore di una barra degli strumenti.
CMFCToolBar::OnUserToolTip	Chiamato dal framework quando la descrizione per un pulsante sta per visualizzare.

Membri di dati

Nome	Descrizione
CMFCToolBar::m_bDontScaleImages	Specifica se ridimensionare o non immagini della barra degli strumenti in modalità elevata di DPI.
CMFCToolBar::m_dblLargeImageRatio	Specifica il rapporto tra la dimensione (l'altezza o la larghezza di immagini di grandi dimensioni e la dimensione delle immagini normali.

Note

Per includere un oggetto CMFCToolBar nell'applicazione, attenersi alla seguente procedura:

Aggiungere un oggetto CMFCToolBar la finestra cornice principale.
Quando si sviluppa il messaggio WM_CREATE per la finestra cornice principale, chiamare CMFCToolBar::Create o CMFCToolBar::CreateEx per creare la barra degli strumenti e per specificare lo stile.
Chiamare CBasePane::EnableDocking per specificare lo stile di ancoraggio.

Per inserire un pulsante speciale, ad esempio una casella combinata o una barra degli strumenti dell'elenco a discesa, riserva un pulsante fittizi nella risorsa padre e sostituisce il pulsante fittizio di runtime utilizzando CMFCToolBar::ReplaceButton. Per ulteriori informazioni, vedere Procedura dettagliata: inserimento di controlli nelle barre degli strumenti.

CMFCToolBar è la classe base per le classi Classe CMFCMenuBar, Classe CMFCPopupMenuBare Classe CMFCDropDownToolBardella libreria MFC.

Esempio

Nell'esempio seguente viene illustrato come utilizzare i vari metodi della classe CMFCToolBar. L'esempio mostra come impostare il testo dell'etichetta di progettazione della barra degli strumenti, impostare bordi, impostare lo stile del riquadro e abilitare il pulsante Aggiungi o rimuovi pulsanti visualizzato alle estremità della barra degli strumenti. Questo frammento di codice fa parte Esempio demo di IE.

    CMFCToolBar     m_wndToolBar;


...


    m_wndToolBar.SetWindowText (_T("Standard"));
    m_wndToolBar.SetBorders ();

    //------------------------------------ 
    // Remove toolbar gripper and borders: 
    //------------------------------------
    m_wndToolBar.SetPaneStyle (m_wndToolBar.GetPaneStyle() &
        ~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

    m_wndToolBar.EnableCustomizeButton (TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));