Classe `CMFCToolBar`

Articolo
10/12/2023

La CMFCToolBar classe è CToolBar simile a Classe, ma fornisce supporto aggiuntivo per le funzionalità dell'interfaccia utente. Queste includono barre degli strumenti flat, barre degli strumenti con immagini con area sensibile, icone grandi, pulsanti cercapersone, barre degli strumenti bloccate, controlli Rebar, testo sotto le immagini, immagini di sfondo e barre degli strumenti a schede. La classe CMFCToolBar contiene inoltre il supporto incorporato per la personalizzazione da parte dell'utente delle barre degli strumenti e dei menu, il trascinamento della selezione tra barre degli strumenti e menu, i pulsanti della casella combinata, i pulsanti della casella di modifica, le selezioni colore e i pulsanti rollup.

Per altri dettagli, vedere il codice sorgente che si trova nell'installazione di Visual Studio, ad esempio %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Sintassi

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 comandi sempre visualizzati quando un utente apre un menu.
`CMFCToolBar::AddCommandUsage`	Incrementa di un contatore associato al comando specificato.
`CMFCToolBar::AddToolBarForImageCollection`	Aggiunge immagini dalle risorse dell'interfaccia utente alla raccolta di immagini nell'applicazione.
`CMFCToolBar::AdjustLayout`	Ricalcola le dimensioni e la posizione di una barra degli strumenti. Esegue l'override di `CBasePane::AdjustLayout`.
`CMFCToolBar::AdjustSize`	Ricalcola le dimensioni della barra degli strumenti.
`CMFCToolBar::AllowChangeTextLabels`	Specifica se le etichette di testo possono essere visualizzate nelle immagini nei pulsanti della barra degli strumenti.
`CMFCToolBar::AreTextLabels`	Specifica se le etichette di testo nelle immagini sono attualmente visualizzate sui pulsanti della barra degli strumenti.
`CMFCToolBar::AutoGrayInactiveImages`	Abilita o disabilita la generazione automatica di immagini pulsante inattive.
`CMFCToolBar::ButtonToIndex`	Restituisce l'indice di un oggetto Class specificato `CMFCToolBarButton` nella barra degli strumenti.
`CMFCToolBar::CalcFixedLayout`	Calcola le dimensioni orizzontali della barra degli strumenti. Esegue l'override di `CBasePane::CalcFixedLayout`.
`CMFCToolBar::CalcSize`	Chiamato dal framework come parte del processo di calcolo del layout. Esegue l'override di `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. Esegue l'override di `CBasePane::CanBeClosed`.
`CMFCToolBar::CanBeRestored`	Determina se il sistema può ripristinare uno stato originale di una barra degli strumenti dopo la personalizzazione.
`CMFCToolBar::CanFocus`	Specifica se il riquadro può ricevere lo stato attivo. Esegue l'override di `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 sulla barra degli strumenti con un ID di comando specificato.
`CMFCToolBar::Create`	Crea un oggetto `CMFCToolBar`.
`CMFCToolBar::CreateEx`	Crea un `CMFCToolBar` oggetto che utilizza opzioni di stile aggiuntive, ad esempio icone di grandi dimensioni.
`CMFCToolBar::Deactivate`	Disattiva la barra degli strumenti.
`CMFCToolBar::EnableCustomizeButton`	Abilita o disabilita il pulsante Aggiungi o Rimuovi pulsanti visualizzato sulla fine della barra degli strumenti.
`CMFCToolBar::EnableDocking`	Abilita l'ancoraggio del riquadro al frame principale. Esegue l'override di `CBasePane::EnableDocking`.
`CMFCToolBar::EnableLargeIcons`	Abilita o disabilita le icone di grandi dimensioni nei pulsanti della barra degli strumenti.
`CMFCToolBar::EnableQuickCustomization`	Abilita o disabilita la personalizzazione rapida delle barre degli strumenti in modo che l'utente possa premere ALT e trascinare un pulsante in una nuova posizione.
`CMFCToolBar::EnableReflections`	Abilita o disabilita la reflection dei comandi.
`CMFCToolBar::EnableTextLabels`	Abilita o disabilita le etichette di testo sotto le immagini dei pulsanti della barra degli strumenti.
`CMFCToolBar::FromHandlePermanent`	Recupera un puntatore all'oggetto che contiene l'handle `CMFCToolBar` di finestra specificato.
`CMFCToolBar::GetAllButtons`	Restituisce un elenco di sola lettura di pulsanti in 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 all'oggetto `CMFCToolBarButton` con un indice del pulsante della barra degli strumenti specificato.
`CMFCToolBar::GetButtonInfo`	Restituisce l'ID del comando, lo stile e l'indice dell'immagine del pulsante in corrispondenza di un indice specificato.
`CMFCToolBar::GetButtonSize`	Restituisce le dimensioni di ogni pulsante sulla barra degli strumenti.
`CMFCToolBar::GetButtonStyle`	Restituisce lo stile corrente del pulsante della barra degli strumenti che si trova in corrispondenza dell'indice specificato.
`CMFCToolBar::GetButtonText`	Restituisce l'etichetta di testo di un pulsante con un indice specificato.
`CMFCToolBar::GetColdImages`	Restituisce un puntatore all'insieme di immagini del pulsante della barra degli strumenti ad accesso sporadico nell'applicazione.
`CMFCToolBar::GetColumnWidth`	Restituisce la larghezza dei pulsanti della barra degli strumenti.
`CMFCToolBar::GetCommandButtons`	Restituisce un elenco di pulsanti con un ID di comando specificato da tutte le barre degli strumenti dell'applicazione.
`CMFCToolBar::GetCount`	Restituisce il numero di pulsanti e separatori sulla 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 specificato.
`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 all'insieme di immagini utilizzate per i pulsanti di menu disabilitati nell'applicazione.
`CMFCToolBar::GetDroppedDownMenu`	Recupera un puntatore all'oggetto pulsante di menu che attualmente visualizza il relativo sottomenu.
`CMFCToolBar::GetGrayDisabledButtons`	Specifica se le immagini dei pulsanti disabilitati sono versioni in grigio delle immagini normali dei pulsanti o ricavate dalla raccolta di immagini dei pulsanti disabilitate.
`CMFCToolBar::GetHighlightedButton`	Restituisce un puntatore al pulsante della barra degli strumenti attualmente evidenziato.
`CMFCToolBar::GetHotBorder`	Determina se i pulsanti della barra degli strumenti sono attivati.
`CMFCToolBar::GetHotTextColor`	Restituisce il colore del testo dei pulsanti della barra degli strumenti evidenziati.
`CMFCToolBar::GetHwndLastFocus`	Restituisce un handle alla finestra con lo stato attivo di input subito prima che la barra degli strumenti abbia eseguito.
`CMFCToolBar::GetIgnoreSetText`	Specifica se le chiamate per impostare le etichette dei pulsanti vengono ignorate.
`CMFCToolBar::GetImageSize`	Restituisce le dimensioni correnti delle immagini dei pulsanti della barra degli strumenti.
`CMFCToolBar::GetImages`	Restituisce un puntatore alla raccolta di immagini del pulsante predefinite nell'applicazione.
`CMFCToolBar::GetImagesOffset`	Restituisce l'offset dell'indice utilizzato per trovare le immagini del pulsante della barra degli strumenti per questa barra degli strumenti nell'elenco globale delle immagini dei pulsanti della barra degli strumenti.
`CMFCToolBar::GetInvalidateItemRect`	Recupera l'area dell'area client che deve essere ridisegnata per il pulsante in corrispondenza dell'indice specificato.
`CMFCToolBar::GetItemID`	Restituisce l'ID comando del pulsante della barra degli strumenti in corrispondenza di un indice specificato.
`CMFCToolBar::GetItemRect`	Restituisce il rettangolo di delimitazione del pulsante in corrispondenza di un indice specificato.
`CMFCToolBar::GetLargeColdImages`	Restituisce un puntatore all'insieme di immagini di pulsanti della barra degli strumenti ad accesso sporadico di grandi dimensioni nell'applicazione.
`CMFCToolBar::GetLargeDisabledImages`	Restituisce un puntatore all'insieme di immagini del pulsante della barra degli strumenti disabilitate di grandi dimensioni nell'applicazione.
`CMFCToolBar::GetLargeImages`	Restituisce un puntatore all'insieme di immagini di pulsanti della barra degli strumenti di grandi dimensioni nell'applicazione.
`CMFCToolBar::GetLockedColdImages`	Restituisce un puntatore all'insieme di immagini ad accesso sporadico bloccate nella barra degli strumenti.
`CMFCToolBar::GetLockedDisabledImages`	Restituisce un puntatore all'insieme di immagini disabilitate bloccate nella barra degli strumenti.
`CMFCToolBar::GetLockedImages`	Restituisce un puntatore all'insieme di immagini di pulsanti bloccati nella barra degli strumenti.
`CMFCToolBar::GetLockedImageSize`	Restituisce le dimensioni predefinite delle immagini della barra degli strumenti bloccate.
`CMFCToolBar::GetLockedMenuImages`	Restituisce un puntatore all'insieme di immagini di menu della barra degli strumenti bloccate nella barra degli strumenti.
`CMFCToolBar::GetMenuButtonSize`	Restituisce le dimensioni dei pulsanti di menu nell'applicazione.
`CMFCToolBar::GetMenuImageSize`	Restituisce le dimensioni delle immagini dei pulsanti di menu nell'applicazione.
`CMFCToolBar::GetMenuImages`	Restituisce un puntatore all'insieme di immagini dei pulsanti di menu nell'applicazione.
`CMFCToolBar::GetOrigButtons`	Recupera l'insieme di pulsanti non personalizzati della barra degli strumenti.
`CMFCToolBar::GetOrigResetButtons`	Recupera la raccolta di pulsanti di reimpostazione non personalizzati della barra degli strumenti.
`CMFCToolBar::GetResourceID`	Recupera l'ID risorsa della barra degli strumenti.
`CMFCToolBar::GetRouteCommandsViaFrame`	Determina quale oggetto, il frame padre o il proprietario, invia i comandi alla barra degli strumenti.
`CMFCToolBar::GetRowHeight`	Restituisce l'altezza dei pulsanti della barra degli strumenti.
`CMFCToolBar::GetShowTooltips`	Specifica se i suggerimenti degli strumenti vengono 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 del pulsante della barra degli strumenti definite dall'utente 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 nella barra degli strumenti.
`CMFCToolBar::InvalidateButton`	Invalida l'area client del pulsante della barra degli strumenti presente nell'indice specificato.
`CMFCToolBar::IsAddRemoveQuickCustomize`	Determina se un utente può aggiungere o rimuovere pulsanti della barra degli strumenti tramite l'opzione di menu Personalizza .
`CMFCToolBar::IsAltCustomizeMode`	Specifica se viene utilizzata una personalizzazione rapida per trascinare un pulsante.
`CMFCToolBar::IsAutoGrayInactiveImages`	Specifica se la generazione automatica di immagini dei pulsanti inattive (non evidenziate) è abilitata.
`CMFCToolBar::IsBasicCommand`	Determina se un comando è presente nell'elenco dei comandi di base.
`CMFCToolBar::IsButtonExtraSizeAvailable`	Determina se la barra degli strumenti può visualizzare pulsanti con bordi estesi.
`CMFCToolBar::IsButtonHighlighted`	Determina se un pulsante sulla barra degli strumenti è evidenziato.
`CMFCToolBar::IsCommandPermitted`	Determina se è consentito un comando.
`CMFCToolBar::IsCommandRarelyUsed`	Determina se un comando viene usato raramente (vedere `CMFCToolBar::SetCommandUsageOptions`).
`CMFCToolBar::IsCustomizeMode`	Specifica se il framework della barra degli strumenti è in modalità di personalizzazione.
`CMFCToolBar::IsDragButton`	Determina se viene trascinato un pulsante della barra degli strumenti.
`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 le barre degli strumenti nell'applicazione attualmente visualizzano icone di grandi dimensioni.
`CMFCToolBar::IsLastCommandFromButton`	Determina se il comando eseguito più di recente è 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 relativa barra degli strumenti di pari livello sono posizionate nella 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 immagini di grandi dimensioni.
`CMFCToolBar::LoadParameters`	Carica le opzioni globali della barra degli strumenti dal Registro di sistema di Windows.
`CMFCToolBar::LoadState`	Carica le informazioni sullo stato della barra degli strumenti dal Registro di sistema di Windows. Esegue l'override di `CPane::LoadState`.
`CMFCToolBar::LoadToolBar`	Carica la barra degli strumenti dalle risorse dell'applicazione.
`CMFCToolBar::LoadToolBarEx`	Carica la barra degli strumenti dalle risorse dell'applicazione usando la `CMFCToolBarInfo` classe helper per consentire all'applicazione di usare immagini di grandi dimensioni.
`CMFCToolBar::OnChangeHot`	Chiamato dal framework quando un utente seleziona un pulsante sulla barra degli strumenti.
`CMFCToolBar::OnFillBackground`	Chiamato dal framework da `CBasePane::DoPaint` per riempire lo sfondo della barra degli strumenti.
`CMFCToolBar::OnReset`	Ripristina lo stato originale della barra degli strumenti.
`CMFCToolBar::OnSetAccData`	Esegue l'override di `CBasePane::OnSetAccData`.
`CMFCToolBar::OnSetDefaultButtonText`	Ripristina lo stato predefinito del testo di un pulsante della barra degli strumenti.
`CMFCToolBar::OnUpdateCmdUI`	Usato internamente.
`CMFCToolBar::RemoveAllButtons`	Rimuove tutti i pulsanti dalla barra degli strumenti.
`CMFCToolBar::RemoveButton`	Rimuove il pulsante con l'indice specificato dalla barra degli strumenti.
`CMFCToolBar::RemoveStateFromRegistry`	Elimina le informazioni sullo stato per la barra degli strumenti dal Registro di sistema di Windows.
`CMFCToolBar::ReplaceButton`	Sostituisce un pulsante della barra degli strumenti con un altro pulsante della barra degli strumenti.
`CMFCToolBar::ResetAll`	Ripristina tutti gli stati originali di tutte le barre degli strumenti.
`CMFCToolBar::ResetAllImages`	Cancella tutte le raccolte di immagini della barra degli strumenti nell'applicazione.
`CMFCToolBar::RestoreOriginalState`	Ripristina lo stato originale di una barra degli strumenti.
`CMFCToolBar::SaveState`	Salva le informazioni sullo stato per la barra degli strumenti nel Registro di sistema di Windows. Esegue l'override di `CPane::SaveState`.
`CMFCToolBar::Serialize`	Esegue l'override di `CBasePane::Serialize`.
`CMFCToolBar::SetBasicCommands`	Imposta l'elenco dei comandi sempre visualizzati quando un utente apre un menu.
`CMFCToolBar::SetButtonInfo`	Imposta l'ID comando, lo stile e l'ID immagine di un pulsante della barra degli strumenti.
`CMFCToolBar::SetButtonStyle`	Imposta lo stile del pulsante della barra degli strumenti in corrispondenza dell'indice specificato.
`CMFCToolBar::SetButtonText`	Imposta l'etichetta di testo di un pulsante della barra degli strumenti.
`CMFCToolBar::SetButtons`	Imposta i pulsanti per la barra degli strumenti.
`CMFCToolBar::SetCommandUsageOptions`	Specifica quando i comandi usati raramente non vengono visualizzati nel menu dell'applicazione.
`CMFCToolBar::SetCustomizeMode`	Abilita o disabilita la modalità di personalizzazione per tutte le barre degli strumenti nell'applicazione.
`CMFCToolBar::SetGrayDisabledButtons`	Specifica se i pulsanti disabilitati sulla barra degli strumenti sono disattivati o se vengono utilizzate immagini disabilitate per i pulsanti disabilitati.
`CMFCToolBar::SetHeight`	Imposta l'altezza della barra degli strumenti.
`CMFCToolBar::SetHotBorder`	Specifica se i pulsanti della barra degli strumenti sono attivati.
`CMFCToolBar::SetHotTextColor`	Imposta il colore del testo per i pulsanti della barra degli strumenti ad accesso frequente.
`CMFCToolBar::SetLargeIcons`	Specifica se i pulsanti della barra degli strumenti visualizzano icone di grandi dimensioni.
`CMFCToolBar::SetLockedSizes`	Imposta le dimensioni dei pulsanti bloccati e delle immagini bloccate sulla barra degli strumenti.
`CMFCToolBar::SetMenuSizes`	Imposta le dimensioni dei pulsanti di menu della barra degli strumenti e le relative immagini.
`CMFCToolBar::SetNonPermittedCommands`	Imposta l'elenco dei comandi che non possono essere eseguiti dall'utente.
`CMFCToolBar::SetOneRowWithSibling`	Posiziona la barra degli strumenti e il relativo elemento di pari livello sulla stessa riga.
`CMFCToolBar::SetPermament`	Specifica se un utente può chiudere la barra degli strumenti.
`CMFCToolBar::SetRouteCommandsViaFrame`	Specifica se il frame padre o il proprietario invia comandi alla barra degli strumenti.
`CMFCToolBar::SetShowTooltips`	Specifica se il framework visualizza suggerimenti per gli strumenti.
`CMFCToolBar::SetSiblingToolBar`	Specifica l'elemento di pari livello della barra degli strumenti.
`CMFCToolBar::SetSizes`	Specifica le dimensioni dei pulsanti e delle immagini su tutte le barre degli strumenti.
`CMFCToolBar::SetToolBarBtnText`	Specifica le proprietà di un pulsante sulla 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'utente nell'applicazione.
`CMFCToolBar::StretchPane`	Estende la barra degli strumenti verticalmente o orizzontalmente. Esegue l'override di `CBasePane::StretchPane`.
`CMFCToolBar::TranslateChar`	Esegue un comando button se il codice del tasto specificato corrisponde a un tasto di scelta rapida valido.
`CMFCToolBar::UpdateButton`	Aggiorna lo stato del pulsante specificato.
`CMFCToolBar::WrapToolBar`	Riposiziona i pulsanti della barra degli strumenti all'interno delle dimensioni specificate.

Metodi protetti

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

Membri dei dati

Nome	Descrizione
`CMFCToolBar::m_bDontScaleImages`	Specifica se ridimensionare o meno le immagini della barra degli strumenti in modalità DPI elevato.
`CMFCToolBar::m_dblLargeImageRatio`	Specifica il rapporto tra la dimensione (altezza o larghezza) di immagini di grandi dimensioni e la dimensione delle immagini regolari.

Osservazioni:

Per incorporare un CMFCToolBar oggetto nell'applicazione, seguire questa procedura:

Aggiungere un CMFCToolBar oggetto alla finestra cornice principale.
Quando si elabora il messaggio WM_CREATE per la finestra cornice principale, chiamare CMFCToolBar::Create o CMFCToolBar::CreateEx per creare la barra degli strumenti e specificarne 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 a discesa, riservare un pulsante fittizio nella risorsa padre e sostituire il pulsante fittizio in fase di esecuzione usando CMFCToolBar::ReplaceButton. Per altre informazioni, vedere Procedura dettagliata: Inserimento di controlli sulle barre degli strumenti.

CMFCToolBarè la classe di base per le classi della libreria MFC Classe,CMFCPopupMenuBar Classe e CMFCDropDownToolBar Classe.CMFCMenuBar

Esempio

L'esempio seguente illustra come usare i vari metodi nella classe CMFCToolBar . Nell'esempio viene illustrato come impostare il testo dell'etichetta della finestra della barra degli strumenti, impostare i bordi, impostare lo stile del riquadro e abilitare il pulsante Aggiungi o Rimuovi pulsanti visualizzato alla fine della barra degli strumenti. Questo frammento di codice fa parte dell'esempio demo di Internet Explorer.

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

Requisiti

Intestazione: afxtoolbar.h

Gerarchia di ereditarietà

CMFCToolBar

`CMFCToolBar::AddBasicCommand`

Aggiunge un comando di menu all'elenco dei comandi sempre visualizzati quando un utente apre un menu.

static void __stdcall AddBasicCommand(UINT uiCmd);

Parametri

uiCmd
[in] Specifica il comando da aggiungere.

Osservazioni:

Quando il menu viene aperto, viene sempre visualizzato un comando di base. Questo metodo è significativo quando l'utente sceglie di visualizzare i comandi usati di recente.

Utilizzare il CMFCToolBar::SetBasicCommands metodo per impostare l'elenco dei comandi sempre visualizzati quando un utente apre un menu. Usare il CMFCToolBar::GetBasicCommands metodo per recuperare l'elenco dei comandi di base usati dall'applicazione.

`CMFCToolBar::AddCommandUsage`

Incrementa di un contatore associato al comando specificato.

static void __stdcall AddCommandUsage(UINT uiCommand);

Parametri

uiCommand
[in] Specifica il contatore dei comandi da incrementare.

Osservazioni:

Il framework chiama questo metodo quando l'utente seleziona una voce di menu.

Il framework usa i contatori dei comandi per visualizzare le voci di menu usate di recente.

Questo metodo incrementa il contatore dei comandi usando il CMFCCmdUsageCount::AddCmd metodo .

`CMFCToolBar::AddToolBarForImageCollection`

Aggiunge immagini dalle risorse dell'interfaccia utente alla raccolta di immagini nell'applicazione.

static BOOL __stdcall AddToolBarForImageCollection(
    UINT uiResID,
    UINT uiBmpResID=0,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parametri

uiResID
[in] ID risorsa di una barra degli strumenti con immagini da caricare.

uiBmpResID
[in] ID risorsa di una bitmap con immagini della barra degli strumenti.

uiColdResID
[in] ID risorsa di una bitmap con immagini della barra degli strumenti "ad accesso sporadico".

uiMenuResID
[in] ID risorsa di una bitmap con immagini di menu.

uiDisabledResID
[in] ID risorsa di una bitmap con immagini della barra degli strumenti disabilitate.

uiMenuDisabledResID
[in] ID risorsa di una bitmap con immagini di menu disabilitate.

Valore restituito

TRUE se il metodo ha esito positivo; FALSE se uiResID o uiBmpResID non specificano risorse valide o si verifica un altro errore.

Osservazioni:

Chiamare questo metodo per caricare una bitmap con immagini della barra degli strumenti e aggiungerla alla raccolta di immagini della barra degli strumenti. Questo metodo crea un oggetto barra degli strumenti temporaneo e chiama CMFCToolBar::LoadToolBar.

`CMFCToolBar::AdjustLayout`

Ricalcola le dimensioni e la posizione di una barra degli strumenti.

virtual void AdjustLayout();

Osservazioni:

Chiamare questo metodo quando la barra degli strumenti è stata creata per ricalcolare le dimensioni e la posizione.

Il framework chiama questo metodo ogni volta che è necessario modificare il layout della barra degli strumenti. Ad esempio, il layout deve cambiare quando l'utente sposta un'altra barra di controllo, ridimensiona una finestra dell'applicazione o personalizza la barra degli strumenti.

Eseguire l'override di questo metodo per fornire il proprio layout dinamico nelle classi derivate da CMFCToolbar.

`CMFCToolBar::AdjustSize`

Ricalcola le dimensioni della barra degli strumenti.

void AdjustSize();

Osservazioni:

Questo metodo assicura che la barra degli strumenti si adatti ai limiti del frame padre. Questo metodo non esegue alcuna operazione se la barra degli strumenti non dispone di frame padre.

Il CMFCToolBar::AdjustLayout metodo chiama questo metodo per ricalcolare le dimensioni se l'elemento padre della barra degli strumenti non è un CMFCReBar oggetto .

`CMFCToolBar::AllowChangeTextLabels`

Specifica se le etichette di testo possono essere visualizzate nelle immagini nei pulsanti della barra degli strumenti.

virtual BOOL AllowChangeTextLabels() const;

Valore restituito

TRUE se è consentito visualizzare etichette di testo sotto le immagini; in caso contrario FALSE, .

Osservazioni:

Questo metodo viene chiamato dalla finestra di dialogo di personalizzazione per determinare se abilitare una casella di controllo Mostra etichette di testo nella pagina Barre degli strumenti per la barra degli strumenti selezionata.

L'implementazione predefinita restituisce TRUE.

Eseguire l'override di questo metodo in un oggetto derivato da CMFCToolBar e restituire FALSE quando non si desidera che l'utente decida se le etichette di testo vengono visualizzate sui pulsanti della barra degli strumenti nelle immagini.

`CMFCToolBar::AllowShowOnList`

Determina se la barra degli strumenti viene visualizzata nell'elenco delle barre degli strumenti nel riquadro Barre degli strumenti della finestra di dialogo Personalizza .

virtual BOOL AllowShowOnList() const;

Valore restituito

TRUE se l'oggetto barra degli strumenti può essere visualizzato nella casella di riepilogo nella pagina di personalizzazione della barra degli strumenti; in caso contrario FALSE, .

Osservazioni:

Questo metodo viene chiamato dal framework per determinare se l'elenco nella pagina di personalizzazione della barra degli strumenti deve includere un particolare oggetto derivato da CMFCToolBar.

L'implementazione predefinita restituisce sempre TRUE. Eseguire l'override di questo metodo quando non si desidera che una barra degli strumenti venga visualizzata nell'elenco delle barre degli strumenti nella finestra di dialogo di personalizzazione.

`CMFCToolBar::AreTextLabels`

Specifica se le etichette di testo nelle immagini sono attualmente visualizzate sui pulsanti della barra degli strumenti.

BOOL AreTextLabels() const;

Valore restituito

TRUE se i pulsanti della barra degli strumenti visualizzano etichette di testo sotto le immagini; in caso contrario FALSE, .

Osservazioni:

Utilizzare CMFCToolBar::EnableTextLabels per specificare se il testo viene visualizzato. Il valore predefinito è FALSE. Chiamare CMFCToolBar::AllowChangeTextLabels per specificare se l'utente può modificare questa impostazione nella finestra di dialogo di personalizzazione.

`CMFCToolBar::AutoGrayInactiveImages`

Abilita o disabilita la generazione automatica di immagini pulsante inattive.

static void AutoGrayInactiveImages(
    BOOL bEnable=TRUE,
    int nGrayImagePercentage=0,
    BOOL bRedrawAllToolbars=TRUE);

Parametri

bEnable
[in] Valore booleano che specifica se dim le immagini inattive. Se questo parametro è TRUE, le immagini inattive vengono disattivate. In caso contrario, le immagini inattive non sono disattivate.

nGrayImagePercentage
[in] Specifica la percentuale di luminanza per le immagini inattive. Se bEnable è FALSE, questo valore viene ignorato.

bRedrawAllToolbars
[in] Valore booleano che specifica se ridisegnare tutte le barre degli strumenti nell'applicazione. Se questo parametro è TRUE, questo metodo ridisegna tutte le barre degli strumenti.

Osservazioni:

Se bEnable è TRUE, il framework usa nGrayImagePercentage per generare immagini inattive dalle immagini normali. In caso contrario, è necessario specificare il set di immagini inattive usando il CMFCToolBar::GetColdImages metodo . L'opzione è disabilitata per impostazione predefinita.

Per ulteriori informazioni sul parametro nGrayImagePercentage, vedere CMFCToolBarImages::GrayImages.

`CMFCToolBar::ButtonToIndex`

Restituisce l'indice di un oggetto Class specificato CMFCToolBarButton nella barra degli strumenti.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

Parametri

pButton
[in] Puntatore all'oggetto pulsante della barra degli strumenti.

Valore restituito

Indice di pButton nell'elenco interno dei pulsanti della barra degli strumenti oppure -1 se il pulsante specificato non è presente sulla barra degli strumenti.

`CMFCToolBar::CalcFixedLayout`

Calcola le dimensioni orizzontali della barra degli strumenti.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametri

bStretch
[in] TRUE per estendere la barra degli strumenti alle dimensioni del frame padre.

bHorz
[in] TRUE per orientare la barra degli strumenti orizzontalmente; FALSE per orientare la barra degli strumenti verticalmente.

Valore restituito

Oggetto CSize che specifica le dimensioni della barra degli strumenti.

Osservazioni:

Questo metodo calcola le dimensioni della barra degli strumenti utilizzando il CMFCToolBar::CalcLayout metodo . Passa il LM_STRETCH flag per il dwMode parametro se bStretch è TRUE. Passa il LM_HORZ flag se bHorz è TRUE.

Vedere l'esempio di VisualStudioDemo per un esempio che usa questo metodo.

`CMFCToolBar::CalcMaxButtonHeight`

Calcola l'altezza massima dei pulsanti nella barra degli strumenti.

virtual int CalcMaxButtonHeight();

Valore restituito

Altezza massima dei pulsanti.

Osservazioni:

Questo metodo calcola l'altezza massima tra tutti i pulsanti della barra degli strumenti sulla barra degli strumenti. L'altezza può variare a seconda di fattori come lo stato di ancoraggio corrente della barra degli strumenti.

Eseguire l'override di questo metodo in una classe derivata da CMFCToolBar per fornire un calcolo dell'altezza personalizzato.

`CMFCToolBar::CalcSize`

Chiamato dal framework come parte del processo di calcolo del layout.

virtual CSize CalcSize(BOOL bVertDock);

Parametri

bVertDock
[in] TRUE per specificare che la barra degli strumenti è ancorata verticalmente; FALSE per specificare che la barra degli strumenti è ancorata orizzontalmente.

Valore restituito

Oggetto CSize che specifica le dimensioni complessive dei pulsanti sulla barra degli strumenti.

Osservazioni:

Questo metodo considera gli attributi che influiscono sulle dimensioni di ogni pulsante, ad esempio l'area dell'etichetta di testo e le dimensioni del bordo.

Se la barra degli strumenti non contiene pulsanti, questo metodo restituisce le dimensioni riservate di un singolo pulsante utilizzando il CMFCToolBar::GetButtonSize metodo .

`CMFCToolBar::CanBeClosed`

Specifica se un utente può chiudere la barra degli strumenti.

virtual BOOL CanBeClosed() const;

Valore restituito

TRUE se la barra degli strumenti può essere chiusa dall'utente; in caso contrario FALSE, .

Osservazioni:

Il framework chiama questo metodo per determinare se l'utente può chiudere una barra degli strumenti. Se il metodo restituisce TRUE, il framework abilita il SC_CLOSE comando nel menu di sistema della barra degli strumenti e l'utente può chiudere la barra degli strumenti usando una casella di controllo nell'elenco delle barre degli strumenti nella finestra di dialogo di personalizzazione.

L'implementazione predefinita restituisce TRUE. Eseguire l'override di questo metodo in una classe derivata da CMFCToolBar per creare oggetti della barra degli strumenti che non possono essere chiusi dall'utente.

`CMFCToolBar::CanBeRestored`

Determina se il sistema può ripristinare uno stato originale di una barra degli strumenti dopo la personalizzazione.

virtual BOOL CanBeRestored() const;

Valore restituito

TRUE se la barra degli strumenti può essere ripristinata dalle risorse dell'applicazione; in caso contrario FALSE, .

Osservazioni:

Il framework chiama questo metodo per determinare se una barra degli strumenti può essere restituita allo stato originale dopo la personalizzazione. Lo stato originale viene caricato dalle risorse dell'applicazione.

Se CanBeRestored restituisce TRUE, la pagina Barre degli strumenti della finestra di dialogo di personalizzazione abilita il pulsante Reimposta per la barra degli strumenti selezionata.

L'implementazione predefinita restituisce TRUE se l'ID risorsa originale della barra degli strumenti quando è stato caricato è diverso da zero. In genere, non è possibile ripristinare solo le barre degli strumenti definite dall'utente.

È possibile eseguire l'override del CanBeRestored metodo per personalizzare questo comportamento nelle classi derivate.

`CMFCToolBar::CanFocus`

Specifica se il riquadro può ricevere lo stato attivo.

virtual BOOL CanFocus() const;

Valore restituito

Questo metodo restituisce FALSE.

Osservazioni:

Questo metodo esegue l'override dell'implementazione della classe di base, , CBasePane::CanFocusperché gli oggetti della barra degli strumenti non possono ricevere lo stato attivo.

`CMFCToolBar::CanHandleSiblings`

Determina se la barra degli strumenti e il relativo elemento di pari livello vengono inseriti nello stesso riquadro.

BOOL CanHandleSiblings();

Valore restituito

TRUE se la barra degli strumenti ha un elemento di pari livello e la barra degli strumenti e il relativo elemento di pari livello sono posizionati nello stesso riquadro; in caso contrario FALSE, .

Osservazioni:

Il metodo interno CMFCCustomizeButton::CreatePopupMenu chiama questo metodo per determinare come visualizzare il menu a comparsa Personalizza . Se questo metodo restituisce TRUE, il framework visualizza i pulsanti Mostra pulsanti in una riga o Mostra pulsanti su due righe .

In genere non è necessario usare questo metodo. Per abilitare il pulsante Personalizza visualizzato sulla barra degli strumenti, chiamare il CMFCToolBar::EnableCustomizeButton metodo . Per abilitare i pulsanti Mostra pulsanti in una riga o Mostra pulsanti in due righe , chiamare CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::CleanUpImages`

Libera le risorse di sistema allocate per le immagini della barra degli strumenti.

static void CMFCToolBar::CleanUpImages();

Osservazioni:

Il framework chiama questo metodo quando un'applicazione viene arrestata.

`CMFCToolBar::CleanUpLockedImages`

Libera le risorse di sistema allocate per le immagini bloccate della barra degli strumenti.

void CleanUpLockedImages();

Osservazioni:

Chiamare questo metodo quando cambia lo stile di visualizzazione dell'applicazione. Vedere l'esempio di VisualStudioDemo per un esempio che usa questo metodo.

`CMFCToolBar::CommandToIndex`

Restituisce l'indice del pulsante sulla barra degli strumenti con un ID di comando specificato.

int CommandToIndex(
    UINT nIDFind,
    int iIndexFirst=0) const;

Parametri

nIDFind
[in] Specifica l'ID comando.

iIndexFirst
[in] Specifica l'indice iniziale da cui iniziare.

Valore restituito

Indice in base zero del pulsante della barra degli strumenti se il metodo ha avuto esito positivo; -1 se non è presente alcun pulsante con l'ID specificato.

Osservazioni:

Un CMFCToolBar oggetto gestisce un elenco interno dei pulsanti sulla barra degli strumenti. Chiamare questa funzione per recuperare l'indice di un pulsante nell'elenco in base all'ID comando del pulsante.

Se iIndex è maggiore di 0, questo metodo ignora qualsiasi pulsante sulla barra degli strumenti con un indice minore di iIndex.

`CMFCToolBar::Create`

Crea un oggetto CMFCToolBar.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID=AFX_IDW_TOOLBAR);

Parametri

pParentWnd
[in] Puntatore alla finestra padre della barra degli strumenti.

dwStyle
[in] Stile della barra degli strumenti. Per l'elenco degli stili, vedi Stili di controllo e pulsante della barra degli strumenti in Windows SDK.

nID
[in] ID della finestra figlio della barra degli strumenti.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario FALSE, .

Osservazioni:

Questo metodo crea una barra di controllo e la collega alla barra degli strumenti. Crea la barra di controllo con lo stile TBSTYLE_FLAT. Chiamare CMFCToolBar::CreateEx se si desidera uno stile diverso della barra di controllo.

`CMFCToolBar::CreateEx`

Crea un CMFCToolBar oggetto che utilizza opzioni di stile aggiuntive, ad esempio icone di grandi dimensioni.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=TBSTYLE_FLAT,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    CRect rcBorders=CRect(1,
    1,
    1,
    1),
    UINT nID=AFX_IDW_TOOLBAR);

Parametri

pParentWnd
[in] Puntatore alla finestra padre della barra degli strumenti.

dwCtrlStyle
[in] Stili aggiuntivi per la creazione dell'oggetto barra di controllo incorporato.

dwStyle
[in] Stile della barra degli strumenti. Per un elenco degli stili appropriati, vedere Stili di controllo della barra degli strumenti e pulsanti .

rcBorders
[in] Oggetto CRect che specifica le larghezze dei bordi della finestra della barra degli strumenti.

nID
[in] ID della finestra figlio della barra degli strumenti.

Valore restituito

Diverso da zero se questo metodo ha esito positivo; in caso contrario, 0.

Osservazioni:

Questo metodo crea una barra di controllo e la collega alla barra degli strumenti.

Chiamare questo metodo invece di CMFCToolBar::Create quando si desidera fornire stili specifici. Ad esempio, impostare su dwCtrlStyle TBSTYLE_FLAT | TBSTYLE_TRANSPARENT per creare una barra degli strumenti simile alle barre degli strumenti utilizzate da Internet Explorer 4.

Esempio

Nell'esempio seguente viene illustrato come usare il CreateEx metodo della CMFCToolBar classe . Questo frammento di codice fa parte dell'esempio demo di Internet Explorer.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::Deactivate`

Disattiva la barra degli strumenti.

virtual void Deactivate();

Osservazioni:

Questo metodo disattiva la barra degli strumenti rimuovendo lo stato attivo dal pulsante della barra degli strumenti evidenziato. Il framework chiama questo metodo quando la barra degli strumenti perde lo stato attivo o viene eliminata definitivamente.

`CMFCToolBar::DoPaint`

Riavforma una barra degli strumenti.

virtual void DoPaint(CDC* pDC);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

Osservazioni:

Questo metodo viene chiamato dal framework quando è necessario aggiornare una parte della barra degli strumenti.

Eseguire l'override di questo metodo per personalizzare l'aspetto di un oggetto derivato da CMFCToolBar.

`CMFCToolBar::DrawButton`

Riavforma un pulsante della barra degli strumenti.

virtual BOOL DrawButton(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CMFCToolBarImages* pImages,
    BOOL bHighlighted,
    BOOL bDrawDisabledImages);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

pButton
[in] Puntatore a un pulsante da disegnare.

pImages
[in] Puntatore alle immagini della barra degli strumenti.

bHighlighted
[in] TRUE se il pulsante è evidenziato; in caso contrario FALSE, .

bDrawDisabledImages
[in] TRUE se i pulsanti disabilitati sono disattivati; in caso contrario FALSE, .

Valore restituito

TRUE se il pulsante è stato ridisegnato; FALSE se il pulsante è nascosto.

Osservazioni:

Il CMFCToolBar::DrawButton metodo chiama questo metodo quando è necessario ridipingere un pulsante della barra degli strumenti.

Eseguire l'override di questo metodo se si desidera personalizzare l'aspetto dei pulsanti sulla barra degli strumenti.

`CMFCToolBar::DrawSeparator`

Riavforma un separatore su una barra degli strumenti.

virtual void DrawSeparator(
    CDC* pDC,
    const CRect& rect,
    BOOL bHorz);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

rect
[in] Rettangolo di delimitazione della posizione in cui viene disegnato il separatore, in pixel.

bHorz
[in] TRUE se il separatore è orizzontale, FALSE se il separatore è verticale.

Osservazioni:

CMFCToolBar::DoPaint chiama questo metodo per ogni CMFCToolBar::DrawSeparator oggetto con lo TBBS_SEPARATOR stile, invece di chiamare CMFCToolBar::DrawButton per tali pulsanti.

Eseguire l'override di questo metodo in una classe derivata da CMFCToolBar per personalizzare l'aspetto dei separatori sulla barra degli strumenti. L'implementazione predefinita chiama CMFCVisualManager::OnDrawSeparator per disegnare un separatore il cui aspetto è determinato dalla gestione visiva corrente.

`CMFCToolBar::EnableCustomizeButton`

Abilita o disabilita il pulsante Personalizza visualizzato sulla barra degli strumenti.

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bQuickCustomize=TRUE);

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    UINT uiCustomizeTextResId,
    BOOL bQuickCustomize=TRUE);

Parametri

bEnable
[in] Abilita o disabilita il pulsante Personalizza.

iCustomizeCmd
[in] ID comando del pulsante Personalizza.

strCustomizeText
[in] Etichetta di testo del pulsante Personalizza.

uiCustomizeTextResId
[in] ID stringa di risorsa dell'etichetta del pulsante Personalizza.

bQuickCustomize
[in] Abilita o disabilita l'opzione Aggiungi o Rimuovi pulsanti nel menu a discesa dal pulsante.

Osservazioni:

Se iCustomizeCmd è -1, il framework visualizza il pulsante Personalizza quando più pulsanti della barra degli strumenti non rientrano nell'area della barra degli strumenti. Il pulsante visualizza una doppia freccia verso sinistra o freccia di espansione, che indica che sono presenti più pulsanti.

Se iCustomizeCmd specifica un ID comando valido e bEnable è TRUE, il pulsante Personalizza viene sempre visualizzato. Il pulsante ha una piccola freccia giù e apre un menu che contiene un comando. Questo comando usa l'etichetta di testo specificata da strCustomizeText. Se bQuickCustomize è anche TRUE, il menu visualizza l'opzione Aggiungi o Rimuovi pulsanti .

Il framework aggiunge dinamicamente al menu tutti i pulsanti che non rientrano nell'area della barra degli strumenti prima dell'elemento specificato da iCustomizeCmd. La freccia di espansione viene visualizzata accanto alla freccia giù.

`CMFCToolBar::EnableDocking`

Abilita l'ancoraggio del riquadro al frame principale.

virtual void EnableDocking(DWORD dwAlignment);

Parametri

dwAlignment
[in] Specifica l'allineamento dell'ancoraggio da abilitare.

Osservazioni:

Questo metodo estende l'implementazione della classe base, CBasePane::EnableDocking, impostando il CBasePane::m_dwControlBarStyle membro dati su AFX_CBRS_FLOAT. Questo metodo passa dwAlignment quindi all'implementazione della classe base.

`CMFCToolBar::EnableLargeIcons`

Abilita o disabilita le icone di grandi dimensioni nei pulsanti della barra degli strumenti.

void EnableLargeIcons(BOOL bEnable);

Parametri

bEnable
[in] TRUE per abilitare icone di grandi dimensioni, FALSE per disabilitare le icone di grandi dimensioni.

Osservazioni:

Per impostazione predefinita, le icone di grandi dimensioni sono abilitate.

`CMFCToolBar::EnableQuickCustomization`

Abilita o disabilita la personalizzazione rapida delle barre degli strumenti in modo che l'utente possa premere ALT e trascinare un pulsante in una nuova posizione.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

Parametri

bEnable
[in] TRUE per abilitare la personalizzazione rapida, FALSE per disabilitare la personalizzazione rapida.

`CMFCToolBar::EnableReflections`

Abilita o disabilita la reflection dei comandi.

void EnableReflections(BOOL bEnable = TRUE);

Parametri

bEnable
[in] TRUE per abilitare la reflection dei comandi; FALSE per disabilitare la reflection dei comandi.

Osservazioni:

Chiamare questo metodo per abilitare la reflection dei comandi per i pulsanti della barra degli strumenti che contengono controlli incorporati, ad esempio caselle combinate.

Per altre informazioni sulla reflection dei comandi, vedere TN062: Reflection dei messaggi per i controlli Windows.

`CMFCToolBar::EnableTextLabels`

Abilita o disabilita le etichette di testo sotto le immagini dei pulsanti della barra degli strumenti.

void EnableTextLabels(BOOL bEnable=TRUE);

Parametri

bEnable
TRUE se le etichette di testo vengono visualizzate sotto le immagini dei pulsanti della barra degli strumenti; in caso contrario FALSE, .

Osservazioni:

Se le etichette di testo sono abilitate, tutti i pulsanti sulla barra degli strumenti vengono ingranditi per fornire spazio alle etichette da visualizzare sotto le immagini. Nella pagina Barre degli strumenti della finestra di dialogo di personalizzazione è presente una casella di controllo Mostra etichetta di testo. Quando l'utente seleziona una barra degli strumenti e controlla questa opzione, il framework chiama EnableTextLabels la barra degli strumenti selezionata. È possibile disabilitare la casella di controllo per un oggetto derivato da CMFCToolBar restituendo FALSE da CMFCToolBar::AllowChangeTextLabels .

`CMFCToolBar::FromHandlePermanent`

Recupera un puntatore all'oggetto che contiene l'handle CMFCToolBar di finestra specificato.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

Parametri

hwnd
[in] Handle della finestra da cercare.

Valore restituito

Puntatore all'oggetto che contiene l'handle CMFCToolBar di finestra specificato o NULL se non esiste alcun oggetto corrispondente CMFCToolBar .

Osservazioni:

Questo metodo condiviso esamina ogni barra degli strumenti nell'applicazione per l'oggetto che contiene l'handle CMFCToolBar di finestra specificato.

`CMFCToolBar::GetAllButtons`

Restituisce un elenco di sola lettura di pulsanti in una barra degli strumenti.

const CObList& GetAllButtons() const;

Valore restituito

Riferimento costante a un CObList oggetto Class , che contiene un insieme di CMFCToolBarButton oggetti Class .

`CMFCToolBar::GetAllToolbars`

Restituisce un elenco di sola lettura di tutte le barre degli strumenti nell'applicazione.

static const CObList& GetAllToolbars();

Valore restituito

Riferimento const a un CObList oggetto Class che contiene una raccolta di CMFCToolBar oggetti .

`CMFCToolBar::GetBasicCommands`

Restituisce un elenco di sola lettura dei comandi di base definiti nell'applicazione.

static const CList<UINT,UINT>& GetBasicCommands();

Valore restituito

Riferimento const a un CList oggetto Class che contiene una raccolta di comandi di base.

Osservazioni:

Aggiungere comandi di base chiamando CMFCToolBar::AddBasicCommand o CMFCToolBar::SetBasicCommands.

`CMFCToolBar::GetButton`

Restituisce un puntatore all'oggetto CMFCToolBarButton Class in corrispondenza di un indice specificato.

CMFCToolBarButton* GetButton(int iIndex) const;

Parametri

iIndex
[in] Specifica l'indice del pulsante da restituire.

Valore restituito

Puntatore al pulsante della barra degli strumenti, se esistente; o NULL se non c'è un pulsante di questo tipo.

`CMFCToolBar::GetButtonInfo`

Restituisce l'ID del comando, lo stile e l'indice dell'immagine del pulsante in corrispondenza di un indice specificato.

void GetButtonInfo(
    int nIndex,
    UINT& nID,
    UINT& nStyle,
    int& iImage) const;

Parametri

nIndex
[in] Specifica l'indice del pulsante nell'elenco dei pulsanti sulla barra degli strumenti.

nID
[out] ID comando di un pulsante.

nStyle
[out] Stile del pulsante.

iImage
[out] Indice dell'immagine per il pulsante.

Osservazioni:

Il GetButtonInfo metodo trova un pulsante della barra degli strumenti in corrispondenza dell'indice specificato e recupera l'ID comando, lo stile e l'indice dell'immagine del pulsante.

Se il pulsante in corrispondenza dell'indice specificato non esiste, il framework imposta nID e nStyle su 0 e iImage su -1 quando il metodo restituisce .

`CMFCToolBar::GetButtonSize`

Restituisce le dimensioni di ogni pulsante sulla barra degli strumenti.

CSize GetButtonSize() const;

Valore restituito

Oggetto CSize Class che specifica le dimensioni di ogni pulsante sulla barra degli strumenti.

Osservazioni:

Chiamare CMFCToolBar::SetSizes o CMFCToolBar::SetLockedSizes per impostare le dimensioni di ogni pulsante sulla barra degli strumenti.

`CMFCToolBar::GetButtonStyle`

Restituisce lo stile corrente del pulsante della barra degli strumenti che si trova in corrispondenza dell'indice specificato.

UINT GetButtonStyle(int nIndex) const;

Parametri

nIndex
[in] Specifica l'indice di un pulsante della barra degli strumenti.

Valore restituito

Valore che specifica lo stile del pulsante della barra degli strumenti. . Per un elenco dei possibili stili, vedere Stili di controllo toolBar.

Osservazioni:

Chiamare CMFCToolBar::SetButtonStyle per impostare lo stile di un pulsante della barra degli strumenti

`CMFCToolBar::GetButtonText`

Restituisce l'etichetta di testo di un pulsante con un indice specificato.

CString GetButtonText(int nIndex) const;

void GetButtonText(
    int nIndex,
    CString& rString) const;

`CMFCToolBar::GetCommandButtons`

Restituisce un elenco di pulsanti con un ID di comando specificato da tutte le barre degli strumenti dell'applicazione.

static int GetCommandButtons(
    UINT uiCmd,
    CObList& listButtons);

Parametri

uiCmd
[in] ID comando dei pulsanti.

listButtons
[out] Riferimento a un CObList oggetto Class che riceve l'elenco dei pulsanti della barra degli strumenti.

Valore restituito

Numero di pulsanti con l'ID comando specificato.

`CMFCToolBar::GetCount`

Restituisce il numero di pulsanti e separatori sulla barra degli strumenti.

int GetCount() const;

Valore restituito

Numero di pulsanti e separatori sulla barra degli strumenti.

`CMFCToolBar::GetCustomizeButton`

Recupera un puntatore all'oggetto CMFCCustomizeButton associato alla barra degli strumenti.

CMFCCustomizeButton* GetCustomizeButton();

Valore restituito

Puntatore all'oggetto CMFCCustomizeButton associato alla barra degli strumenti.

Osservazioni:

Questo metodo recupera il pulsante Personalizza visualizzato alla fine della barra degli strumenti. Usare il CMFCToolBar::EnableCustomizeButton metodo per aggiungere il pulsante Personalizza alla barra degli strumenti.

È possibile chiamare il CMFCToolBar::IsExistCustomizeButton metodo per determinare se la barra degli strumenti contiene un oggetto valido CMFCCustomizeButton .

`CMFCToolBar::GetDefaultImage`

Restituisce l'indice dell'immagine predefinita per un pulsante della barra degli strumenti con un ID di comando specificato.

static int GetDefaultImage(UINT uiID);

Parametri

BOOL GetIgnoreSetText() const;

Valore restituito

TRUE se le chiamate per impostare le etichette dei pulsanti vengono ignorate; in caso contrario, FALSE.

Osservazioni:

`CMFCToolBar::GetImages`

Restituisce un puntatore alla raccolta di immagini del pulsante predefinite nell'applicazione.

static CMFCToolBarImages* GetImages();

Valore restituito

Puntatore all'oggetto Class che contiene l'insieme CMFCToolBarImages di immagini predefinite per tutte le barre degli strumenti dell'applicazione.

Osservazioni:

Questo metodo condiviso consente di accedere alla raccolta di tutte le immagini predefinite della barra degli strumenti per l'applicazione. Chiamare il CMFCToolBar::LoadBitmap metodo per aggiungere immagini alla raccolta.

`CMFCToolBar::GetImageSize`

Restituisce le dimensioni correnti delle immagini dei pulsanti della barra degli strumenti.

CSize GetImageSize() const;

Valore restituito

Oggetto CSize Class che rappresenta le dimensioni correnti delle immagini dei pulsanti della barra degli strumenti.

`CMFCToolBar::GetImagesOffset`

Restituisce l'offset dell'indice utilizzato per trovare le immagini del pulsante della barra degli strumenti per questa barra degli strumenti nell'elenco globale delle immagini dei pulsanti della barra degli strumenti.

int GetImagesOffset() const;

Valore restituito

Offset dell'indice delle immagini della barra degli strumenti.

Osservazioni:

Tutte le immagini predefinite della barra degli strumenti vengono archiviate nell'elenco classe globaleCMFCToolBarImages. Le immagini per ogni pulsante della barra degli strumenti vengono archiviate consecutivamente in tale elenco. Per calcolare l'indice dell'immagine, aggiungere l'indice del pulsante nella barra degli strumenti all'offset dell'inizio dell'elenco di immagini per il pulsante della barra degli strumenti.

Chiamare CMFCToolBar::ButtonToIndex per ottenere l'indice di un pulsante della barra degli strumenti dato un puntatore al pulsante.

Chiamare CMFCToolBar::GetImages per ottenere un puntatore alla raccolta di immagini della barra degli strumenti.

`CMFCToolBar::GetInvalidateItemRect`

Recupera l'area dell'area client che deve essere ridisegnata per il pulsante in corrispondenza dell'indice specificato.

virtual void GetInvalidateItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parametri

nIndex
[in] Indice del pulsante per il quale recuperare l'area client.

lpRect
[out] Puntatore a un RECT oggetto che riceve l'area dell'area client.

Osservazioni:

Il lpRect parametro non deve essere NULL. Se non esiste alcun pulsante in corrispondenza dell'indice specificato, lpRect riceve un RECT oggetto inizializzato su zero.

`CMFCToolBar::GetItemID`

Restituisce l'ID comando del pulsante della barra degli strumenti in corrispondenza di un indice specificato.

UINT GetItemID(int nIndex) const;

Parametri

nIndex
[in] Specifica l'indice del pulsante della barra degli strumenti.

Valore restituito

ID comando del pulsante della barra degli strumenti; oppure zero se il pulsante con l'indice specificato non esiste.

`CMFCToolBar::GetItemRect`

Restituisce il rettangolo di delimitazione del pulsante in corrispondenza di un indice specificato.

virtual void GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parametri

nIndex
[in] Specifica l'indice di un pulsante della barra degli strumenti.

lpRect
[out] Puntatore all'oggetto CRect che riceve le coordinate del rettangolo di delimitazione dell'immagine.

Osservazioni:

Oggetto CRect a cui lpRect i punti sono impostati su 0 se non esiste un pulsante in corrispondenza dell'indice specificato.

Esempio

Nell'esempio seguente viene illustrato come usare il GetItemRect metodo della CMFCToolBar classe . Questo frammento di codice fa parte dell'esempio demo di Internet Explorer.

CMFCToolBar m_wndToolBar;

CRect rectToolBar;
m_wndToolBar.GetItemRect(0, &rectToolBar);

`CMFCToolBar::GetLargeColdImages`

Restituisce un puntatore all'insieme di immagini di pulsanti della barra degli strumenti ad accesso sporadico di grandi dimensioni nell'applicazione.

static CMFCToolBarImages* GetLargeColdImages();

Valore restituito

Puntatore alla raccolta di immagini ad accesso sporadico di grandi dimensioni.

Osservazioni:

Le immagini ad accesso sporadico sono le immagini usate quando l'utente non interagisce con i pulsanti della barra degli strumenti. Chiamare CMFCToolBar::LoadBitmapEx per caricare le immagini ad accesso sporadico di grandi dimensioni.

`CMFCToolBar::GetLargeDisabledImages`

Restituisce un puntatore all'insieme di immagini del pulsante della barra degli strumenti disabilitate di grandi dimensioni nell'applicazione.

static CMFCToolBarImages* GetLargeDisabledImages();

Valore restituito

Puntatore alla raccolta di immagini di pulsanti disabilitati di grandi dimensioni.

Osservazioni:

Le immagini di grandi dimensioni sono versioni estese delle normali immagini dei pulsanti della barra degli strumenti. Chiamare CMFCToolBar::LoadBitmapEx o CMFCToolBar::LoadBitmap per caricare le immagini di grandi dimensioni.

`CMFCToolBar::GetLargeImages`

Restituisce un puntatore all'insieme di immagini di pulsanti della barra degli strumenti di grandi dimensioni nell'applicazione.

static CMFCToolBarImages* GetLargeImages();

Valore restituito

Puntatore alla raccolta di immagini di pulsanti della barra degli strumenti di grandi dimensioni.

Osservazioni:

Le immagini di grandi dimensioni sono versioni estese delle normali immagini dei pulsanti della barra degli strumenti. Chiamare CMFCToolBar::LoadBitmapEx per caricare le immagini di grandi dimensioni.

`CMFCToolBar::GetLockedColdImages`

Restituisce un puntatore all'insieme di immagini ad accesso sporadico bloccate nella barra degli strumenti.

CMFCToolBarImages* GetLockedColdImages();

Valore restituito

Puntatore alla raccolta di immagini ad accesso sporadico bloccate o NULL se la barra degli strumenti non è bloccata.

Osservazioni:

Le immagini bloccate sono versioni delle normali immagini del pulsante della barra degli strumenti usate dal framework quando l'utente non può personalizzare la barra degli strumenti. Le immagini ad accesso sporadico sono le immagini usate quando l'utente non interagisce con i pulsanti della barra degli strumenti.

Questo metodo restituisce NULL se la barra degli strumenti non è bloccata. Questo metodo genera anche un errore di asserzione nelle compilazioni di debug se la barra degli strumenti non è bloccata. Per altre informazioni sulle barre degli strumenti bloccate, vedere CMFCToolBar::IsLocked.

Chiamare il CMFCToolBar::LoadBitmapEx metodo per caricare le immagini ad accesso sporadico bloccate.

`CMFCToolBar::GetLockedDisabledImages`

Restituisce un puntatore all'insieme di immagini disabilitate bloccate nella barra degli strumenti.

CMFCToolBarImages* GetLockedDisabledImages();

Valore restituito

Puntatore alla raccolta di immagini disabilitate bloccate o NULL se la barra degli strumenti non è bloccata.

Osservazioni:

Le immagini bloccate sono versioni delle normali immagini del pulsante della barra degli strumenti usate dal framework quando l'utente non può personalizzare la barra degli strumenti. Le immagini disabilitate sono le immagini usate dal framework quando un pulsante ha lo TBBS_DISABLED stile.

Chiamare il CMFCToolBar::LoadBitmapEx metodo per caricare le immagini disabilitate bloccate.

`CMFCToolBar::GetLockedImages`

Restituisce un puntatore all'insieme di immagini di pulsanti bloccati nella barra degli strumenti.

CMFCToolBarImages* GetLockedImages();

Valore restituito

Puntatore alla raccolta di immagini del pulsante della barra degli strumenti bloccate o NULL se la barra degli strumenti non è bloccata.

Osservazioni:

Le immagini bloccate sono versioni delle normali immagini del pulsante della barra degli strumenti usate dal framework quando l'utente non può personalizzare la barra degli strumenti.

`CMFCToolBar::GetLockedImageSize`

Restituisce le dimensioni predefinite delle immagini della barra degli strumenti bloccate.

CSize GetLockedImageSize() const;

Valore restituito

Struttura CSize che specifica le dimensioni delle immagini della barra degli strumenti bloccate o una struttura vuota CSize se la barra degli strumenti non è bloccata.

Osservazioni:

Le immagini bloccate sono versioni delle normali immagini del pulsante della barra degli strumenti usate dal framework quando l'utente non può personalizzare la barra degli strumenti.

Questo metodo restituisce una CSize struttura con larghezza zero e zero altezza se la barra degli strumenti non è bloccata. Questo metodo genera anche un errore di asserzione nelle compilazioni di debug se la barra degli strumenti non è bloccata. Per altre informazioni sulle barre degli strumenti bloccate, vedere CMFCToolBar::IsLocked.

Chiamare il CMFCToolBar::SetLockedSizes metodo per specificare le dimensioni dell'immagine bloccata.

`CMFCToolBar::GetLockedMenuImages`

Restituisce un puntatore all'insieme di immagini di menu della barra degli strumenti bloccate nella barra degli strumenti.

CMFCToolBarImages* GetLockedMenuImages();

Valore restituito

Puntatore alla raccolta di immagini del menu della barra degli strumenti bloccate o NULL se la barra degli strumenti non è bloccata.

Osservazioni:

Le immagini bloccate sono versioni delle normali immagini del menu della barra degli strumenti usate dal framework quando l'utente non può personalizzare la barra degli strumenti.

Chiamare il CMFCToolBar::LoadBitmapEx metodo per caricare le immagini di menu bloccate.

`CMFCToolBar::GetMenuButtonSize`

Restituisce le dimensioni dei pulsanti di menu nell'applicazione.

static CSize GetMenuButtonSize();

Valore restituito

Oggetto CSize che rappresenta le dimensioni dei pulsanti di menu, in pixel.

Osservazioni:

Le dimensioni dei pulsanti di menu sulle barre degli strumenti vengono mantenute come variabile globale e possono essere recuperate da questo metodo statico.

Chiamare CMFCToolBar::SetMenuSizes per impostare questa variabile globale.

`CMFCToolBar::GetMenuImages`

Restituisce un puntatore all'insieme di immagini dei pulsanti di menu nell'applicazione.

static CMFCToolBarImages* GetMenuImages();

Valore restituito

Puntatore alla raccolta di immagini di menu.

Osservazioni:

Chiamare il CMFCToolBar::LoadBitmapEx metodo per caricare le immagini di menu.

Chiamare il CMFCToolBar::SetMenuSizes metodo per impostare le dimensioni dei pulsanti e le relative immagini.

`CMFCToolBar::GetMenuImageSize`

Restituisce le dimensioni delle immagini dei pulsanti di menu nell'applicazione.

static CSize GetMenuImageSize();

Valore restituito

Oggetto CSize che rappresenta le dimensioni delle immagini di menu.

Osservazioni:

Questo metodo restituisce le dimensioni delle immagini nei pulsanti di menu della barra degli strumenti gestiti come variabile globale. Chiamare CMFCToolBar::SetMenuSizes per impostare questa variabile globale.

`CMFCToolBar::GetOrigButtons`

Recupera l'insieme di pulsanti non personalizzati della barra degli strumenti.

const CObList& GetOrigButtons() const;

Valore restituito

Riferimento all'elenco di pulsanti non personalizzati della barra degli strumenti.

Osservazioni:

Il framework crea una copia dei pulsanti della barra degli strumenti prima che vengano personalizzati dall'utente. Il CMFCToolBar::SetButtons metodo aggiunge una copia di ogni pulsante nella matrice fornita all'elenco dei pulsanti originali. Il CMFCToolBar::RestoreOriginalState metodo ripristina lo stato originale della barra degli strumenti caricandolo dal file di risorse.

Per impostare l'elenco dei pulsanti originali per la barra degli strumenti, chiamare il CMFCToolBar::SetOrigButtons metodo .

`CMFCToolBar::GetOrigResetButtons`

Recupera la raccolta di pulsanti di reimpostazione non personalizzati della barra degli strumenti.

const CObList& GetOrigResetButtons() const;

Valore restituito

Riferimento all'elenco di pulsanti di reimpostazione non personalizzati della barra degli strumenti.

Osservazioni:

Quando l'utente seleziona il pulsante Reimposta durante la modalità di personalizzazione, il framework usa questo metodo per ripristinare i pulsanti rimossi dalla barra degli strumenti.

Il CMFCToolBar::SetButtons metodo aggiunge una copia di ogni pulsante della barra degli strumenti all'elenco dei pulsanti di reimpostazione originali dopo aver chiamato il CMFCToolBar::OnReset metodo . È possibile eseguire l'override del CMFCToolBar::OnReset metodo per personalizzare l'aspetto dei pulsanti dopo che l'utente preme il pulsante Reimposta .

`CMFCToolBar::GetResourceID`

Recupera l'ID risorsa della barra degli strumenti.

UINT GetResourceID() const;

Valore restituito

ID risorsa della barra degli strumenti.

Osservazioni:

Chiamare il CMFCToolBar::LoadToolBarEx metodo per impostare l'ID risorsa della barra degli strumenti.

`CMFCToolBar::GetRouteCommandsViaFrame`

Determina quale oggetto, il frame padre o il proprietario, invia i comandi alla barra degli strumenti.

BOOL GetRouteCommandsViaFrame();

Valore restituito

Diverso da zero se il frame padre invia comandi alla barra degli strumenti; 0 se il proprietario invia comandi alla barra degli strumenti.

Osservazioni:

Per impostazione predefinita, il frame padre invia comandi alla barra degli strumenti. Chiamare CMFCToolBar::SetRouteCommandsViaFrame per modificare questo comportamento.

Se questo metodo restituisce un valore diverso da zero, è possibile recuperare un puntatore all'oggetto frame padre usando il CMFCToolBar::GetCommandTarget metodo . Vedere l'esempio di VisualStudioDemo per un esempio che usa questo metodo.

`CMFCToolBar::GetRowHeight`

Restituisce l'altezza dei pulsanti della barra degli strumenti.

virtual int GetRowHeight() const;

Valore restituito

Altezza dei pulsanti della barra degli strumenti, in pixel.

Osservazioni:

Il framework chiama questo metodo per calcolare il layout della barra degli strumenti. Eseguire l'override di questo metodo in una classe derivata per specificare un'altezza diversa per la barra degli strumenti.

`CMFCToolBar::GetShowTooltips`

Specifica se i suggerimenti degli strumenti vengono visualizzati per i pulsanti della barra degli strumenti.

static BOOL GetShowTooltips();

Valore restituito

TRUE se vengono visualizzati i suggerimenti degli strumenti per i pulsanti della barra degli strumenti; in caso contrario FALSE, .

Osservazioni:

Per impostazione predefinita vengono visualizzati i suggerimenti per gli strumenti. È possibile modificare questo flag statico chiamando CMFCToolBar::SetShowTooltips.

`CMFCToolBar::GetSiblingToolBar`

Recupera l'elemento di pari livello della barra degli strumenti.

CMFCToolBar* GetSiblingToolBar();

Valore restituito

Puntatore alla barra degli strumenti di pari livello.

Osservazioni:

Per altre informazioni su come abilitare i pulsanti Mostra pulsanti in una riga e Mostra pulsanti in due righe , vedere CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::GetUserImages`

Restituisce un puntatore alla raccolta di immagini del pulsante della barra degli strumenti definite dall'utente nell'applicazione.

static CMFCToolBarImages* GetUserImages();

Valore restituito

Puntatore alla raccolta di immagini del pulsante della barra degli strumenti definite dall'utente per tutte le barre degli strumenti dell'applicazione.

Osservazioni:

Chiamare il CMFCToolBar::SetUserImages metodo per impostare la raccolta di immagini definite dall'utente nell'applicazione.

`CMFCToolBar::HitTest`

Restituisce l'indice del pulsante della barra degli strumenti che si trova nella posizione specificata.

virtual int HitTest(CPoint point);

Parametri

point
[in] Punto da testare, nelle coordinate client.

Valore restituito

Indice del pulsante che si trova nella posizione specificata oppure -1 se non è presente un pulsante di questo tipo o il pulsante è un separatore.

`CMFCToolBar::InsertButton`

Inserisce un pulsante nella barra degli strumenti.

virtual int InsertButton(
    const CMFCToolBarButton& button,
    INT_PTR iInsertAt=-1);

virtual int InsertButton(
    CMFCToolBarButton* pButton,
    int iInsertAt=-1);

Parametri

button
[in] Specifica il pulsante da inserire.

iInsertAt
[in] Specifica la posizione in base zero in cui inserire il pulsante.

Valore restituito

Posizione in cui è stato inserito il pulsante o -1 se si verifica un errore.

Osservazioni:

Se iInsertAt è -1, questo metodo aggiunge il pulsante alla fine dell'elenco dei pulsanti della barra degli strumenti.

Chiamare il CMFCToolBar::InsertSeparator metodo per inserire un separatore nella barra degli strumenti.

`CMFCToolBar::InsertSeparator`

Inserisce un separatore nella barra degli strumenti.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

Parametri

iInsertAt
[in] Specifica la posizione in base zero in corrispondenza della quale inserire il separatore. Questo parametro deve essere maggiore di 0.

Valore restituito

Posizione in cui è stato inserito il separatore o -1 se si verifica un errore.

Osservazioni:

Chiamare questo metodo per inserire un separatore tra due pulsanti esistenti. Se iInsertAt è -1, questo metodo aggiunge il separatore alla fine dell'elenco dei pulsanti della barra degli strumenti.

Non è possibile utilizzare questo metodo per aggiungere un separatore a una barra degli strumenti vuota.

Chiamare il CMFCToolBar::InsertButton metodo per inserire un pulsante nella barra degli strumenti.

`CMFCToolBar::InvalidateButton`

Invalida l'area client del pulsante della barra degli strumenti presente nell'indice specificato.

CMFCToolBarButton* InvalidateButton(int nIndex);

Parametri

nIndex
[in] Indice in base zero del pulsante sulla barra degli strumenti.

Valore restituito

Puntatore all'oggetto CMFCToolBarButton presente nell'indice specificato o NULL se tale oggetto non esiste.

Osservazioni:

Il framework chiama questo metodo quando aggiorna l'area client associata a un pulsante della barra degli strumenti. Chiama il CWnd::InvalidateRect metodo con il rettangolo client dell'oggetto CMFCToolBarButton esistente in corrispondenza dell'indice specificato.

`CMFCToolBar::IsAddRemoveQuickCustomize`

Determina se un utente può aggiungere o rimuovere pulsanti della barra degli strumenti tramite l'opzione di menu Personalizza .

BOOL IsAddRemoveQuickCustomize();

Valore restituito

TRUE se un utente può utilizzare l'opzione di menu Personalizza per modificare la barra degli strumenti; in caso contrario, FALSE.

Osservazioni:

`CMFCToolBar::IsAltCustomizeMode`

Specifica se viene utilizzata una personalizzazione rapida per trascinare un pulsante. Quando la personalizzazione rapida è abilitata, un utente può tenere premuto il tasto ALT e trascinare un pulsante in una nuova posizione.

static BOOL __stdcall IsAltCustomizeMode();

Valore restituito

TRUE se viene usata una personalizzazione rapida per trascinare un pulsante; in caso contrario, FALSE.

Osservazioni:

`CMFCToolBar::IsAutoGrayInactiveImages`

Specifica se la generazione automatica di immagini dei pulsanti inattive (non evidenziate) è abilitata.

static BOOL IsAutoGrayInactiveImages();

Valore restituito

TRUE se l'opzione per rimuovere automaticamente le immagini inattive è abilitata; in caso contrario FALSE, .

Osservazioni:

È possibile abilitare o disabilitare la regolazione automatica delle immagini inattive chiamando CMFCToolBar::AutoGrayInactiveImages.

`CMFCToolBar::IsBasicCommand`

Determina se un comando è presente nell'elenco dei comandi di base.

static BOOL IsBasicCommand(UINT uiCmd);

Parametri

uiCmd
[in] Specifica il comando da controllare.

Valore restituito

TRUE se il comando specificato appartiene all'elenco dei comandi di base; in caso contrario FALSE, .

Osservazioni:

Questo metodo statico determina se il comando specificato da uiCmd appartiene all'elenco globale dei comandi di base. È possibile modificare l'elenco dei comandi di base chiamando CMFCToolBar::AddBasicCommand o CMFCToolBar::SetBasicCommands.

`CMFCToolBar::IsButtonExtraSizeAvailable`

Determina se la barra degli strumenti può visualizzare pulsanti con bordi estesi.

virtual BOOL IsButtonExtraSizeAvailable() const;

Valore restituito

TRUE se la barra può visualizzare pulsanti con le dimensioni del bordo aggiuntive; in caso contrario FALSE, .

Osservazioni:

L'oggetto barra degli strumenti restituisce TRUE se può visualizzare pulsanti con bordi estesi. Un pulsante della barra degli strumenti chiama questo metodo quando gestisce la CMFCToolBarButton::OnChangeParentWnd notifica e imposta di conseguenza il flag interno di dimensioni aggiuntive del bordo. Questo flag interno può essere recuperato in un secondo momento chiamando CMFCToolBarButton::IsExtraSize.

Eseguire l'override di questo metodo in una classe derivata da CMFCToolBar e restituire TRUE se la barra può visualizzare i pulsanti della barra degli strumenti con le dimensioni aggiuntive del bordo e restituire FALSE in caso contrario. L'implementazione predefinita restituisce TRUE.

`CMFCToolBar::IsButtonHighlighted`

Determina se il pulsante specificato è evidenziato.

BOOL IsButtonHighlighted(int iButton) const;

Parametri

iButton
[in] Specifica l'indice di un pulsante della barra degli strumenti.

Valore restituito

TRUE se il pulsante specificato è evidenziato; in caso contrario, FALSE.

Osservazioni:

`CMFCToolBar::IsCommandPermitted`

Determina se è consentito un comando.

static BOOL IsCommandPermitted(UINT uiCmd);

Parametri

uiCmd
[in] Specifica il comando da controllare.

Valore restituito

TRUE se il comando specificato è consentito; in caso contrario FALSE, .

Osservazioni:

Questo metodo statico determina se il comando specificato da uiCmd appartiene all'elenco globale di comandi non consentiti.

È possibile modificare l'elenco dei comandi non consentiti chiamando CMFCToolBar::SetNonPermittedCommands.

`CMFCToolBar::IsCommandRarelyUsed`

Determina se un comando viene usato raramente.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

Parametri

uiCmd
[in] Specifica il comando da controllare.

Valore restituito

TRUE se il comando specificato viene usato raramente; in caso contrario FALSE, .

Osservazioni:

Il IsCommandRarelyUsed metodo restituisce FALSE quando si verifica una o più delle condizioni seguenti:

Il comando specificato appartiene all'elenco dei comandi di base
Il comando specificato è uno dei comandi standard
Il framework è in modalità di personalizzazione
L'elenco dei comandi di base è vuoto
Più del 20% delle chiamate ai comandi sono chiamate al comando specificato.

`CMFCToolBar::IsCustomizeMode`

Specifica se il framework della barra degli strumenti è in modalità di personalizzazione.

static BOOL IsCustomizeMode();

Valore restituito

TRUE se il framework è in modalità di personalizzazione; in caso contrario FALSE, .

Osservazioni:

È possibile attivare o disattivare la modalità di personalizzazione chiamando CMFCToolBar::SetCustomizeMode.

Il framework modifica la modalità quando l'utente richiama la finestra di dialogo di personalizzazione ( CMFCToolBarsCustomizeDialog Classe).

`CMFCToolBar::IsDragButton`

Determina se viene trascinato un pulsante della barra degli strumenti.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

Parametri

pButton
[in] Puntatore a un pulsante della barra degli strumenti.

Valore restituito

TRUE se il pulsante specificato viene trascinato; in caso contrario, FALSE.

Osservazioni:

`CMFCToolBar::IsExistCustomizeButton`

Determina se la barra degli strumenti contiene il pulsante Personalizza .

BOOL IsExistCustomizeButton();

Valore restituito

TRUE se la barra degli strumenti contiene il pulsante Personalizza ; in caso contrario FALSE, .

Osservazioni:

Se questo metodo restituisce TRUE, il CMFCToolBar::GetCustomizeButton metodo restituisce un puntatore al pulsante Personalizza visualizzato alla fine della barra degli strumenti.

Usare il CMFCToolBar::EnableCustomizeButton metodo per aggiungere il pulsante Personalizza alla barra degli strumenti.

`CMFCToolBar::IsFloating`

Determina se la barra degli strumenti è mobile.

virtual BOOL IsFloating() const;

Valore restituito

TRUE se la barra degli strumenti è mobile; in caso contrario, FALSE.

`CMFCToolBar::IsLargeIcons`

Specifica se le barre degli strumenti nell'applicazione attualmente visualizzano icone di grandi dimensioni.

static BOOL IsLargeIcons();

Valore restituito

TRUE se l'applicazione usa icone di grandi dimensioni; in caso contrario FALSE, .

Osservazioni:

Chiamare CMFCToolBar::SetLargeIcons per alternare icone di grandi dimensioni e icone normali.

Il framework modifica automaticamente la modalità quando l'utente attiva o disattiva la casella di controllo Icone grandi nella pagina Opzioni della finestra di dialogo Personalizzazione .

`CMFCToolBar::IsLastCommandFromButton`

Determina se il comando eseguito più di recente è stato inviato dal pulsante della barra degli strumenti specificato.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

Parametri

pButton
[in] Puntatore al pulsante.

Valore restituito

TRUE se l'ultimo comando è stato inviato dal pulsante che pButton specifica; in caso contrario FALSE, .

Osservazioni:

Questo metodo ottiene un puntatore a una MSG struttura chiamando CWnd::GetCurrentMessage. Confronta quindi l'oggetto HWND del pulsante con i MSG::lParam membri e MSG::hwnd per determinare se il pulsante è l'origine del comando.

`CMFCToolBar::IsLocked`

Determina se la barra degli strumenti è bloccata.

BOOL IsLocked() const;

Valore restituito

TRUE se la barra degli strumenti è bloccata; in caso contrario, FALSE.

Osservazioni:

Questo metodo restituisce TRUE quando l'utente non può eseguire attività di personalizzazione, ad esempio il riposizionamento dei pulsanti della barra degli strumenti.

Le barre degli strumenti bloccate usano elenchi di immagini separati. Per altre informazioni su questi elenchi di immagini, vedere CMFCToolBar::LoadBitmapEx.

`CMFCToolBar::IsOneRowWithSibling`

Determina se la barra degli strumenti e la relativa barra degli strumenti di pari livello sono posizionate nella stessa riga.

BOOL IsOneRowWithSibling();

Valore restituito

TRUE se la barra degli strumenti e il relativo elemento di pari livello sono posizionati sulla stessa riga; in caso contrario FALSE, .

Osservazioni:

Il CMFCCustomizeButton::CreatePopupMenu metodo chiama questo metodo per determinare come visualizzare il menu a comparsa Personalizza . Se questo metodo restituisce TRUE, il framework visualizza il pulsante Mostra pulsanti in una riga . In caso contrario, nel framework viene visualizzato il pulsante Mostra pulsanti in due righe .

In genere non è necessario usare questo metodo. Per abilitare i pulsanti Mostra pulsanti in una riga o Mostra pulsanti in due righe , chiamare CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::IsResourceChanged`

virtual BOOL IsResourceChanged() const;

Valore restituito

Osservazioni:

`CMFCToolBar::IsSibling`

BOOL IsSibling();

Valore restituito

Osservazioni:

`CMFCToolBar::IsUserDefined`

Specifica se la barra degli strumenti è definita dall'utente.

BOOL IsUserDefined() const;

Valore restituito

TRUE se la barra degli strumenti è stata creata dall'utente; in caso contrario FALSE, .

`CMFCToolBar::LoadBitmap`

Carica le immagini della barra degli strumenti dalle risorse dell'applicazione.

virtual BOOL LoadBitmap(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parametri

uiResID
[in] ID risorsa della bitmap che fa riferimento alle immagini della barra degli strumenti ad accesso frequente.

uiColdResID
[in] ID risorsa della bitmap che fa riferimento alle immagini della barra degli strumenti ad accesso sporadico.

uiMenuResID
[in] ID risorsa della bitmap che fa riferimento alle normali immagini di menu.

bLocked
[in] TRUE per bloccare la barra degli strumenti; in caso contrario FALSE, .

uiDisabledResID
[in] ID risorsa della bitmap che fa riferimento alle immagini della barra degli strumenti disabilitate.

uiMenuDisabledResID
[in] ID risorsa della bitmap che fa riferimento alle immagini di menu disabilitate.

Valore restituito

Diverso da zero se il metodo ha esito positivo; in caso contrario, zero.

Osservazioni:

Il CMFCToolBar::LoadToolBarEx metodo chiama questo metodo per caricare le immagini associate alla barra degli strumenti. Eseguire l'override di questo metodo per eseguire il caricamento personalizzato delle risorse immagine.

Chiamare il metodo LoadBitmapEx per caricare immagini aggiuntive dopo aver creato la barra degli strumenti.

`CMFCToolBar::LoadBitmapEx`

virtual BOOL LoadBitmapEx(
    CMFCToolBarInfo& params,
    BOOL bLocked = FALSE);

Parametri

[in] params
[in] bLocked\

Valore restituito

Osservazioni:

`CMFCToolBar::LoadLargeIconsState`

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

Parametri

[in] lpszProfileName\

Valore restituito

Osservazioni:

`CMFCToolBar::LoadParameters`

Carica le opzioni globali della barra degli strumenti dal Registro di sistema di Windows.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

Parametri

lpszProfileName
[in] Specifica il percorso relativo della chiave del Registro di sistema di Windows.

Valore restituito

Diverso da zero se il metodo ha esito positivo; in caso contrario, zero.

Osservazioni:

Questo metodo carica parametri globali, ad esempio il tipo di animazione del menu, lo stile di ombreggiatura del menu e se visualizzare icone di grandi dimensioni dal Registro di sistema di Windows.

Il CWinAppEx::LoadState metodo chiama questo metodo come parte del processo di inizializzazione dell'applicazione.

`CMFCToolBar::LoadState`

Carica le informazioni sullo stato della barra degli strumenti dal Registro di sistema di Windows.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parametri

lpszProfileName
[in] Specifica il percorso relativo della chiave del Registro di sistema di Windows.

nIndex
[in] Specifica l'ID del controllo della barra degli strumenti.

uiID
[in] Specifica l'ID risorsa della barra degli strumenti.

Valore restituito

Diverso da zero se il metodo ha esito positivo; in caso contrario, zero.

Osservazioni:

Il framework chiama questo metodo come parte del processo di inizializzazione dell'applicazione. Per ulteriori informazioni, vedere CWinAppEx::LoadState.

`CMFCToolBar::LoadToolBar`

Carica la barra degli strumenti dalle risorse dell'applicazione.

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0,
    UINT uiHotResID=0);

Parametri

uiResID
[in] ID risorsa della barra degli strumenti.

uiColdResID
[in] ID risorsa della bitmap che fa riferimento alle immagini della barra degli strumenti ad accesso sporadico.

uiMenuResID
[in] ID risorsa della bitmap che fa riferimento alle normali immagini di menu.

bLocked
[in] Valore booleano che specifica se la barra degli strumenti è bloccata o meno. Se questo parametro è TRUE, la barra degli strumenti è bloccata. In caso contrario, la barra degli strumenti non è bloccata.

uiDisabledResID
[in] ID risorsa della bitmap che fa riferimento alle immagini della barra degli strumenti disabilitate.

uiMenuDisabledResID
[in] ID risorsa della bitmap che fa riferimento alle immagini di menu disabilitate.

uiHotResID
[in] ID risorsa della bitmap che fa riferimento alle immagini della barra degli strumenti ad accesso frequente.

Valore restituito

Diverso da zero se il metodo ha esito positivo; in caso contrario, zero.

Osservazioni:

Il framework chiama questo metodo durante l'inizializzazione per caricare le immagini associate alla barra degli strumenti.

Esempio

Nell'esempio seguente viene illustrato come usare il LoadToolBar metodo nella CMFCToolBar classe . Questo frammento di codice fa parte dell'esempio demo di Internet Explorer.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::LoadToolBarEx`

Carica la barra degli strumenti dalle risorse dell'applicazione usando la CMFCToolBarInfo classe helper per consentire all'applicazione di usare immagini di grandi dimensioni.

virtual BOOL LoadToolBarEx(
    UINT uiToolbarResID,
    CMFCToolBarInfo& params,
    BOOL bLocked=FALSE);

Parametri

uiToolbarResID
[in] ID risorsa della barra degli strumenti.

params
[in] Riferimento a un CMFCToolBarInfo oggetto contenente gli ID risorsa per le immagini della barra degli strumenti.

bLocked
[in] Valore booleano che specifica se la barra degli strumenti è bloccata o meno. Se questo parametro è TRUE, la barra degli strumenti è bloccata. In caso contrario, la barra degli strumenti non è bloccata.

Valore restituito

Diverso da zero se il metodo ha esito positivo; in caso contrario, zero.

Osservazioni:

Chiamare questo metodo per caricare immagini della barra degli strumenti dalle risorse dell'applicazione.

`CMFCToolBar::m_dblLargeImageRatio`

Specifica il rapporto tra la dimensione (altezza o larghezza) di immagini di grandi dimensioni e la dimensione delle immagini regolari.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

Osservazioni:

Il rapporto predefinito è 2. È possibile modificare questo valore per ingrandire o ridimensionare le immagini della barra degli strumenti di grandi dimensioni.

Il framework usa questo membro dati quando non si specifica un set di immagini di grandi dimensioni. Ad esempio, se si specifica solo il set di immagini di piccole dimensioni con dimensioni 16x16 e si vuole che le immagini di grandi dimensioni abbiano le dimensioni 24x24, impostare questo membro dati su 1,5.

`CMFCToolBar::NextMenu`

virtual BOOL NextMenu();

Valore restituito

Osservazioni:

`CMFCToolBar::OnBeforeRemoveButton`

virtual BOOL OnBeforeRemoveButton(
    CMFCToolBarButton* pButton,
    DROPEFFECT dropEffect);

Parametri

pButton
[in] Inutilizzato.

dropEffect
[in] Inutilizzato.

Valore restituito

Osservazioni:

`CMFCToolBar::OnChangeHot`

Chiamato dal framework quando un utente seleziona un pulsante sulla barra degli strumenti.

virtual void OnChangeHot(int iHot);

Parametri

iHot
[in] Specifica l'indice del pulsante della barra degli strumenti selezionato; oppure -1 se non è selezionato alcun pulsante della barra degli strumenti.

Osservazioni:

Eseguire l'override di questo metodo per elaborare le notifiche che l'utente ha selezionato un pulsante su una barra degli strumenti.

`CMFCToolBar::OnChangeVisualManager`

virtual void OnChangeVisualManager();

Osservazioni:

`CMFCToolBar::OnFillBackground`

Chiamato dal framework da CBasePane::DoPaint per riempire lo sfondo della barra degli strumenti.

virtual void OnFillBackground(CDC* pDC);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

Osservazioni:

CMFCToolBar::DoPaint chiama questo metodo quando lo sfondo di una barra degli strumenti è stato riempito. L'implementazione predefinita non esegue alcuna operazione.

Eseguire l'override di questo metodo per disegnare uno sfondo personalizzato nelle classi derivate.

`CMFCToolBar::OnGlobalFontsChanged`

virtual void OnGlobalFontsChanged();

Osservazioni:

`CMFCToolBar::OnReset`

Ripristina lo stato originale della barra degli strumenti.

virtual void OnReset();

Osservazioni:

Eseguire l'override di questo metodo per gestire la notifica relativa alla reimpostazione della barra degli strumenti.

L'implementazione predefinita non esegue alcuna operazione. Eseguire l'override OnReset in una classe derivata da CMFCToolBar quando la barra degli strumenti dispone di pulsanti fittizi che devono essere sostituiti quando la barra degli strumenti torna allo stato originale.

`CMFCToolBar::OnSetAccData`

virtual BOOL OnSetAccData(long lVal);

Parametri

[in] lVal\

Valore restituito

Osservazioni:

`CMFCToolBar::OnSetDefaultButtonText`

Ripristina lo stato predefinito del testo di un pulsante della barra degli strumenti.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parametri

pButton
[in] Punta a un pulsante, il cui testo è impostato.

Valore restituito

TRUE se il testo è stato ripristinato correttamente; in caso contrario FALSE, .

Osservazioni:

Eseguire l'override di questo metodo per elaborare le notifiche che il testo di un pulsante della barra degli strumenti viene modificato nel valore predefinito.

L'implementazione predefinita carica il testo di un pulsante dalle risorse dell'applicazione.

`CMFCToolBar::OnUserToolTip`

Chiamato dal framework quando la descrizione comando per un pulsante sta per essere visualizzata.

virtual BOOL OnUserToolTip(
    CMFCToolBarButton* pButton,
    CString& strTTText) const;

Parametri

pButton
[in] Punta a un pulsante della barra degli strumenti per il quale deve essere visualizzata una descrizione comando.

strTTText
[out] Riferimento all'oggetto CString che riceve il testo della descrizione comando.

Valore restituito

TRUE se strTTText è stato popolato con il testo della descrizione comando; in caso contrario FALSE, .

Osservazioni:

Il framework chiama questo metodo quando la descrizione comando per un pulsante della barra degli strumenti sta per essere visualizzata. Se OnUserToolTip restituisce TRUE, il framework visualizza una descrizione comando contenente il testo restituito da OnUserToolTip in strTTText. In caso contrario, la descrizione comando contiene il testo del pulsante.

Eseguire l'override per personalizzare OnUserToolTip i suggerimenti degli strumenti dei pulsanti della barra degli strumenti. Le chiamate CMFCToolBar::OnUserToolTip di implementazione predefinite per ottenere il testo della descrizione comando.

`CMFCToolBar::PrevMenu`

virtual BOOL PrevMenu();

Valore restituito

Osservazioni:

`CMFCToolBar::ProcessCommand`

Invia un WM_COMMAND messaggio alla finestra proprietaria della barra degli strumenti.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

Parametri

pButton
[in] Puntatore a un pulsante sulla barra degli strumenti.

Valore restituito

Questo metodo deve restituire sempre TRUE. MFC usa FALSE i valori internamente.

Osservazioni:

Questo metodo invia un WM_COMMAND messaggio alla finestra proprietaria della barra degli strumenti chiamando CWnd::PostMessage e passando l'ID comando del pulsante specificato come wParam parametro.

Utilizzare la ON_COMMAND macro per eseguire il mapping del WM_COMMAND messaggio a una funzione membro.

`CMFCToolBar::RemoveAllButtons`

Rimuove tutti i pulsanti e i separatori dalla barra degli strumenti.

virtual void RemoveAllButtons();

Osservazioni:

Il framework chiama questo metodo quando ricrea o elimina definitivamente una barra degli strumenti.

`CMFCToolBar::RemoveButton`

Rimuove dalla barra degli strumenti il pulsante con l'indice specificato.

virtual BOOL RemoveButton(int iIndex);

Parametri

iIndex
[in] Specifica l'indice in base zero del pulsante da rimuovere.

Valore restituito

TRUE se il metodo ha esito positivo o FALSE se l'indice specificato non è valido o l'indice fa riferimento al pulsante Personalizza .

Osservazioni:

Questo metodo aggiorna gli attributi aggiuntivi della barra degli strumenti interessati dalla rimozione del pulsante. Ad esempio, questo metodo rimuove i separatori non essenziali dalla barra degli strumenti e ricompila la tabella dei tasti di scelta rapida.

Per altre informazioni sul pulsante Personalizza , vedere CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::RemoveStateFromRegistry`

Elimina le informazioni sullo stato per la barra degli strumenti dal Registro di sistema di Windows.

virtual BOOL RemoveStateFromRegistry(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parametri

lpszProfileName
[in] Specifica la chiave del Registro di sistema in cui si trovano le informazioni sullo stato.

nIndex
[in] ID del controllo della barra degli strumenti.

uiID
[in] ID risorsa della barra degli strumenti. Se questo parametro è -1, questo metodo usa il CWnd::GetDlgCtrlID metodo per recuperare l'ID risorsa.

Valore restituito

Diverso da zero se il metodo ha esito positivo; in caso contrario, zero.

Osservazioni:

Il framework chiama questo metodo quando elimina una barra degli strumenti definita dall'utente.

Eseguire l'override di questo metodo se si archiviano informazioni aggiuntive sullo stato nel Registro di sistema di Windows.

`CMFCToolBar::ReplaceButton`

Sostituisce un pulsante della barra degli strumenti con un altro pulsante della barra degli strumenti.

int ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button,
    BOOL bAll=FALSE);

Parametri

uiCmd
[in] ID del comando del pulsante da sostituire.

button
[in] Riferimento all'oggetto CMFCToolBarButton da inserire.

bAll
[in] Valore booleano che specifica se sostituire tutti i pulsanti con l'ID comando specificato da uiCmd. Se questo parametro è TRUE, tutti i pulsanti con l'ID comando specificato vengono sostituiti. In caso contrario, il primo pulsante viene sostituito.

Valore restituito

Numero di pulsanti sostituiti. Questo metodo restituisce 0 se non esiste un pulsante con l'ID comando specificato sulla barra degli strumenti.

Osservazioni:

Chiamare questo metodo quando si desidera aggiungere pulsanti della barra degli strumenti che non possono essere caricati dalle risorse. È possibile creare un pulsante segnaposto in fase di progettazione e sostituirlo con un pulsante personalizzato quando si inizializza la barra degli strumenti. Vedere l'esempio di VisualStudioDemo per un esempio che usa questo metodo.

Esempio

Nell'esempio seguente viene illustrato come usare il ReplaceButton metodo nella CMFCToolBar classe . Questo frammento di codice fa parte dell'esempio demo di Internet Explorer.

CMFCToolBar m_wndToolBar;

// CMenu menuHistory
// CString str
m_wndToolBar.ReplaceButton(ID_GO_BACK,
                           CMFCToolBarMenuButton(ID_GO_BACK, menuHistory,
                                                 GetCmdMgr()->GetCmdImage(ID_GO_BACK), str));

`CMFCToolBar::ResetAll`

Ripristina tutti gli stati originali di tutte le barre degli strumenti.

static void __stdcall ResetAll();

Osservazioni:

Questo metodo chiama il CMFCToolBar::RestoreOriginalState metodo su ogni barra degli strumenti dell'applicazione che può essere ripristinata. Usa il CMFCToolBar::CanBeRestored metodo per determinare se è possibile ripristinare una barra degli strumenti.

`CMFCToolBar::ResetAllImages`

Cancella tutte le raccolte di immagini della barra degli strumenti nell'applicazione.

static void __stdcall ResetAllImages();

Osservazioni:

Questo metodo cancella le raccolte di immagini inizializzate dai CMFCToolBar::LoadToolBar metodi e CMFCToolBar::LoadBitmap .

`CMFCToolBar::ResetImages`

virtual void ResetImages();

Osservazioni:

`CMFCToolBar::RestoreFocus`

virtual void RestoreFocus();

Osservazioni:

`CMFCToolBar::RestoreOriginalState`

Ripristina lo stato originale di una barra degli strumenti.

virtual BOOL RestoreOriginalState();

Valore restituito

TRUE se il metodo ha esito positivo o FALSE se il metodo ha esito negativo o la barra degli strumenti è definita dall'utente.

Osservazioni:

Questo metodo carica la barra degli strumenti dal file di risorse usando il CMFCToolBar::LoadToolBar metodo .

Il framework chiama questo metodo quando l'utente sceglie il pulsante Reimposta tutto nella pagina Barre degli strumenti di una finestra di dialogo di personalizzazione.

`CMFCToolBar::SaveParameters`

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

Parametri

[in] lpszProfileName\

Valore restituito

Osservazioni:

`CMFCToolBar::SaveState`

Salva le informazioni sullo stato per la barra degli strumenti nel Registro di sistema di Windows.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parametri

lpszProfileName
[in] Specifica il percorso relativo della chiave del Registro di sistema di Windows.

nIndex
[in] ID del controllo della barra degli strumenti.

uiID
[in] ID risorsa della barra degli strumenti.

Valore restituito

Diverso da zero se il metodo ha esito positivo; in caso contrario, zero.

Osservazioni:

Il framework chiama questo metodo quando salva lo stato dell'applicazione nel Registro di sistema. Per ulteriori informazioni, vedere CWinAppEx::SaveState.

`CMFCToolBar::SetBasicCommands`

Imposta l'elenco dei comandi sempre visualizzati quando un utente apre un menu.

static void __stdcall SetBasicCommands(CList<UINT,UINT>& lstCommands);

Parametri

lstCommands
[in] Riferimento a un CList oggetto che contiene una raccolta di comandi.

Osservazioni:

Quando il menu viene aperto, viene sempre visualizzato un comando di base. Questo metodo è significativo quando l'utente sceglie di visualizzare i comandi usati di recente.

Usare il CMFCToolBar::AddBasicCommand metodo per aggiungere un comando all'elenco dei comandi di base. Usare il CMFCToolBar::GetBasicCommands metodo per recuperare l'elenco dei comandi di base usati dall'applicazione.

Vedere l'esempio di Explorer per un esempio che usa questo metodo.

`CMFCToolBar::SetButtonInfo`

Imposta l'ID comando, lo stile e l'ID immagine di un pulsante della barra degli strumenti.

void SetButtonInfo(
    int nIndex,
    UINT nID,
    UINT nStyle,
    int iImage);

Parametri

nIndex
[in] Indice in base zero del pulsante le cui proprietà sono impostate.

nID
[in] ID del comando del pulsante.

nStyle
[in] Stile del pulsante. Vedi Stili di controllo della barra degli strumenti per l'elenco degli stili dei pulsanti disponibili.

iImage
[in] Indice dell'immagine in base zero del pulsante, ovvero l'indice nella raccolta di immagini della barra degli strumenti.

Osservazioni:

Chiamare questo metodo per impostare le proprietà di un pulsante della barra degli strumenti.

Nelle compilazioni di debug questo metodo genera un errore di asserzione se l'indice specificato da nIndex non è valido.

Chiamare il CMFCToolBar::SetButtonStyle metodo per impostare solo lo stile del pulsante.

`CMFCToolBar::SetButtons`

Imposta i pulsanti per la barra degli strumenti.

virtual BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount,
    BOOL bRemapImages=TRUE);

Parametri

lpIDArray
[in] Puntatore alla matrice di ID comando dei pulsanti da inserire.

nIDCount
[in] Numero di elementi in lpIDArray.

bRemapImages
[in] Valore booleano che specifica se associare le immagini dei pulsanti esistenti ai pulsanti inseriti. Se questo parametro è TRUE, le immagini vengono mappate di nuovo.

Valore restituito

Diverso da zero se il metodo ha esito positivo; in caso contrario, zero.

Osservazioni:

Chiamare questo metodo per rimuovere i pulsanti esistenti da una barra degli strumenti e inserire una raccolta di nuovi pulsanti.

Questo metodo aggiunge il pulsante Personalizza alla barra degli strumenti e invia il AFX_WM_RESETTOOLBAR messaggio alla finestra padre della barra degli strumenti. Per altre informazioni sul pulsante Personalizza , vedere CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::SetButtonStyle`

Imposta lo stile del pulsante della barra degli strumenti in corrispondenza dell'indice specificato.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Parametri

nIndex
[in] Indice in base zero del pulsante della barra degli strumenti il cui stile deve essere impostato.

nStyle
[in] Stile del pulsante. Vedi Stili di controllo della barra degli strumenti per l'elenco degli stili dei pulsanti disponibili.

Osservazioni:

Questo metodo rimuove lo TBBS_PRESSED stile se nStyle è TBBS_DISABLED perché l'utente non può selezionare un pulsante disabilitato.

`CMFCToolBar::SetButtonText`

Imposta l'etichetta di testo di un pulsante della barra degli strumenti.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Parametri

nIndex
[in] Indice del pulsante della barra degli strumenti.

lpszText
[in] Etichetta di testo del pulsante della barra degli strumenti. Deve essere diverso da Null.

Valore restituito

TRUE se il metodo ha esito positivo; in caso contrario FALSE, .

Osservazioni:

Questo metodo restituisce FALSE se l'indice specificato non fa riferimento a un pulsante valido della barra degli strumenti.

`CMFCToolBar::SetCommandUsageOptions`

Specifica quando i comandi usati raramente non vengono visualizzati nel menu dell'applicazione.

static BOOL SetCommandUsageOptions(
    UINT nStartCount,
    UINT nMinUsagePercentage=5);

Parametri

nStartCount
[in] Specifica il numero di volte in cui i comandi devono essere eseguiti prima che il framework mostri solo i comandi di base e usati di recente.

nMinUsagePercentage
[in] Percentuale di volte in cui un comando deve essere eseguito per essere considerato un comando usato di recente.

Valore restituito

FALSE se nMinUsagePercentage è uguale o maggiore di 100; in caso contrario TRUE, .

Osservazioni:

Chiamare questo metodo per personalizzare l'algoritmo usato dal framework per determinare la modalità di visualizzazione delle voci di menu di base e usate di recente. Per altre informazioni sui comandi di base, vedere CMFCToolBar::AddBasicCommand.

Questa classe usa la CMFCCmdUsageCount classe per tenere traccia del numero di utilizzo dei comandi. Per altre informazioni su questa classe, vedere CMFCCmdUsageCount Classe.

`CMFCToolBar::SetCustomizeMode`

Abilita o disabilita la modalità di personalizzazione per tutte le barre degli strumenti nell'applicazione.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

Parametri

bSet
[in] Valore booleano che specifica se abilitare o disabilitare la modalità di personalizzazione. Impostare questo parametro su TRUE per abilitare la modalità di personalizzazione o FALSE disabilitarla.

Valore restituito

TRUE se la chiamata a questo metodo cambia la modalità di personalizzazione; in caso contrario FALSE, .

Osservazioni:

Questo metodo regola il layout di e ridisegna ogni barra degli strumenti nell'applicazione. Chiamare il CMFCToolBar::IsCustomizeMode metodo per determinare se l'applicazione è in modalità di personalizzazione,

`CMFCToolBar::SetGrayDisabledButtons`

Specifica se i pulsanti non disponibili sulla barra degli strumenti sono disattivati o se vengono usate immagini non disponibili.

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

Parametri

bGrayDisabledButtons
[in] Valore booleano che specifica come visualizzare i pulsanti non disponibili. Se questo parametro è TRUE, il framework suddivide i pulsanti. In caso contrario, il framework usa la raccolta di immagini button-unavailable.

Osservazioni:

Per impostazione predefinita, i pulsanti non disponibili sono disattivati.

`CMFCToolBar::SetHeight`

Imposta l'altezza della barra degli strumenti.

void SetHeight(int cyHeight);

Parametri

cyHeight
[in] Altezza della barra degli strumenti, in pixel.

Osservazioni:

Questo metodo ridisegna la barra degli strumenti dopo aver impostato l'altezza.

`CMFCToolBar::SetHelpMode`

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

Parametri

[in] bOn\

Osservazioni:

`CMFCToolBar::SetHot`

BOOL SetHot(CMFCToolBarButton* pMenuButton);

Parametri

[in] pMenuButton\

Valore restituito

Osservazioni:

`CMFCToolBar::SetHotBorder`

Specifica se i pulsanti della barra degli strumenti sono attivati.

void SetHotBorder(BOOL bShowHotBorder);

Parametri

bShowHotBorder
[in] Valore booleano che specifica se tenere traccia dei pulsanti della barra degli strumenti a caldo. Se questo parametro è TRUE, la barra degli strumenti tiene traccia dei relativi pulsanti. In caso contrario, la barra degli strumenti non tiene traccia dei pulsanti.

Osservazioni:

Se un pulsante viene rilevato a caldo, il framework evidenzia il pulsante quando il mouse si sposta su di esso. Per impostazione predefinita, ogni barra degli strumenti tiene traccia dei relativi pulsanti.

Chiamare il CMFCToolBar::GetHotBorder metodo per determinare se la barra degli strumenti tiene traccia dei relativi pulsanti.

`CMFCToolBar::SetHotTextColor`

Imposta il colore del testo per i pulsanti della barra degli strumenti ad accesso frequente.

static void SetHotTextColor(COLORREF clrText);

Parametri

clrText
[in] Specifica il colore del testo per i pulsanti della barra degli strumenti rilevati a caldo.

Osservazioni:

Per altre informazioni sui pulsanti della barra degli strumenti a rilevamento frequente, vedere CMFCToolBar::GetHotBorder e CMFCToolBar::SetHotBorder.

`CMFCToolBar::SetIgnoreSetText`

void SetIgnoreSetText(BOOL bValue);

Parametri

[in] bValue\

Osservazioni:

`CMFCToolBar::SetLargeIcons`

Specifica se i pulsanti della barra degli strumenti visualizzano icone di grandi dimensioni.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

Parametri

bLargeIcons
[in] Valore booleano che specifica le icone da utilizzare. Se questo parametro è TRUE, il framework visualizza icone di grandi dimensioni. In caso contrario, il framework visualizza le icone normali.

Osservazioni:

Il framework chiama questo metodo quando l'utente modifica lo stato della casella di controllo Icone grandi nella scheda Opzioni della finestra di dialogo Personalizza . Questo metodo ridimensiona tutte le barre degli strumenti nell'applicazione.

Per impostazione predefinita, il framework visualizza le icone normali.

Per altre informazioni sulla finestra di dialogo Personalizza , vedere CMFCToolBarsCustomizeDialog Classe.

`CMFCToolBar::SetLockedSizes`

Imposta le dimensioni dei pulsanti bloccati e delle immagini bloccate sulla barra degli strumenti.

void SetLockedSizes(
    SIZE sizeButton,
    SIZE sizeImage,
    BOOL bDontScale = FALSE);

Parametri

sizeButton
[in] Specifica le dimensioni dei pulsanti della barra degli strumenti bloccati.

sizeImage
[in] Specifica le dimensioni delle immagini della barra degli strumenti bloccate.

bDontScale
Specifica se ridimensionare o meno le immagini della barra degli strumenti bloccate in modalità DPI elevato.

Osservazioni:

Le dimensioni predefinite dei pulsanti bloccati sono 23x22 pixel. Le dimensioni predefinite delle immagini bloccate sono 16x15 pixel.

Chiamare il CMFCToolBar::GetLockedImageSize metodo per recuperare le dimensioni delle immagini bloccate. Chiamare il CMFCToolBar::GetButtonSize metodo per recuperare le dimensioni dei pulsanti della barra degli strumenti bloccati.

`CMFCToolBar::SetMaskMode`

void SetMaskMode(BOOL bMasked);

Parametri

[in] bMasked\

Osservazioni:

`CMFCToolBar::SetMenuSizes`

Imposta le dimensioni dei pulsanti di menu della barra degli strumenti e le relative immagini.

static void __stdcall SetMenuSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parametri

sizeButton
[in] Specifica le dimensioni dei pulsanti della barra degli strumenti, in pixel.

sizeImage
[in] Specifica le dimensioni delle immagini della barra degli strumenti, in pixel.

Osservazioni:

Per impostazione predefinita, i pulsanti di menu e le relative immagini hanno una dimensione non definita.

Chiamare il CMFCToolBar::GetMenuButtonSize metodo per determinare le dimensioni dei pulsanti di menu e il CMFCToolBar::GetMenuImageSize metodo per determinare le dimensioni delle immagini dei pulsanti di menu.

Per esempi che usano questo metodo, vedere gli esempi IEDemo e MSMoneyDemo.

`CMFCToolBar::SetNonPermittedCommands`

Imposta l'elenco dei comandi che non possono essere eseguiti dall'utente.

static void SetNonPermittedCommands(CList<UINT,UINT>& lstCommands);

Parametri

lstCommands
[in] Riferimento a un CList oggetto che contiene i comandi che non possono essere eseguiti dall'utente.

Osservazioni:

Chiamare questo metodo per impedire all'utente di selezionare determinati comandi. Ad esempio, è possibile impedire all'utente di selezionare determinati comandi per motivi di sicurezza. Per esempi che usano questo metodo, vedere gli esempi MDITabsDemo e MenuSubSet.

Questo metodo cancella l'elenco precedente di comandi non consentiti. Per impostazione predefinita, l'elenco di comandi non consentiti è vuoto.

`CMFCToolBar::SetOneRowWithSibling`

Posiziona la barra degli strumenti e il relativo elemento di pari livello sulla stessa riga.

void SetOneRowWithSibling();

Osservazioni:

Il framework chiama questo metodo quando l'utente seleziona il pulsante Mostra pulsanti in una riga .

Chiamare il CMFCToolBar::SetSiblingToolBar metodo per abilitare i pulsanti Mostra pulsanti in una riga o Mostra pulsanti su due righe . Se si chiama CMFCToolBar::SetSiblingToolBar questa barra degli strumenti, la barra degli strumenti di pari livello viene spostata nella riga della barra degli strumenti. In caso contrario, questa barra degli strumenti viene spostata nella riga dell'elemento di pari livello.

Il framework chiama il CMFCToolBar::SetTwoRowsWithSibling metodo quando l'utente seleziona il pulsante Mostra pulsanti in due righe .

`CMFCToolBar::SetOrigButtons`

void SetOrigButtons(const CObList& lstOrigButtons);

Parametri

[in] lstOrigButtons\

Osservazioni:

`CMFCToolBar::SetPermament`

Specifica se un utente può chiudere la barra degli strumenti.

void SetPermament(BOOL bPermament=TRUE);

Parametri

bPermament
[in] Valore booleano che specifica se un utente può chiudere la barra degli strumenti. Se questo parametro è TRUE, un utente non può chiudere la barra degli strumenti. In caso contrario, un utente può chiudere la barra degli strumenti.

Osservazioni:

Per impostazione predefinita, un utente può chiudere ogni barra degli strumenti.

Chiamare il CMFCToolBar::CanBeClosed metodo per determinare se un utente può chiudere la barra degli strumenti.

`CMFCToolBar::SetRouteCommandsViaFrame`

Specifica se il frame padre o il proprietario invia comandi alla barra degli strumenti.

void SetRouteCommandsViaFrame(BOOL bValue);

Parametri

bValue
[in] Se questo parametro è TRUE, il frame padre invia comandi alla barra degli strumenti. In caso contrario, il proprietario invia comandi alla barra degli strumenti.

Osservazioni:

Per impostazione predefinita, il frame padre invia comandi alla barra degli strumenti. Chiamare il CMFCToolBar::GetRouteCommandsViaFrame metodo per determinare se il frame padre o il proprietario invia comandi alla barra degli strumenti.

`CMFCToolBar::SetShowTooltips`

Specifica se il framework visualizza suggerimenti per gli strumenti.

static void SetShowTooltips(BOOL bValue);

Parametri

bValue
[in] Se questo parametro è TRUE, il framework mostra i suggerimenti per gli strumenti. In caso contrario, il framework nasconde i suggerimenti degli strumenti.

Osservazioni:

Per impostazione predefinita, il framework mostra i suggerimenti per gli strumenti.

Chiamare il CMFCToolBar::GetShowTooltips metodo per determinare se il framework mostra i suggerimenti per gli strumenti.

`CMFCToolBar::SetSiblingToolBar`

Specifica l'elemento di pari livello della barra degli strumenti.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

Parametri

pBrotherToolbar
[in] Puntatore alla barra degli strumenti di pari livello.

Osservazioni:

Questo metodo abilita i pulsanti Mostra pulsanti su una riga o Mostra pulsanti in due righe visualizzati quando l'utente visualizza il menu a comparsa Personalizza . Chiamare questo metodo quando si desidera consentire all'utente di specificare se le barre degli strumenti correlate vengono visualizzate nella stessa riga o in righe diverse.

Chiamare questo metodo dopo aver abilitato il pulsante Personalizza visualizzato sulla barra degli strumenti. Per abilitare il pulsante Personalizza , chiamare il CMFCToolBar::EnableCustomizeButton metodo .

Per recuperare l'elemento di pari livello di una barra degli strumenti, chiamare CMFCToolBar::GetSiblingToolBar.

`CMFCToolBar::SetSizes`

Specifica le dimensioni dei pulsanti e delle immagini su tutte le barre degli strumenti.

static void __stdcall SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parametri

sizeButton
[in] Dimensioni dei pulsanti della barra degli strumenti, in pixel.

sizeImage
[in] Dimensioni delle immagini dei pulsanti della barra degli strumenti, in pixel.

Osservazioni:

Le dimensioni predefinite dei pulsanti della barra degli strumenti sono 23x22 pixel. Le dimensioni predefinite delle immagini dei pulsanti della barra degli strumenti sono 16x15 pixel.

Chiamare il CMFCToolBar::GetImageSize metodo per recuperare le dimensioni delle immagini dei pulsanti della barra degli strumenti. Chiamare il CMFCToolBar::GetButtonSize metodo per recuperare le dimensioni dei pulsanti della barra degli strumenti.

`CMFCToolBar::SetToolBarBtnText`

Specifica le proprietà di un pulsante sulla barra degli strumenti.

void SetToolBarBtnText(
    UINT nBtnIndex,
    LPCTSTR szText=NULL,
    BOOL bShowText=TRUE,
    BOOL bShowImage=TRUE);

Parametri

nBtnIndex
[in] Indice in base zero del pulsante della barra degli strumenti nell'elenco dei pulsanti della barra degli strumenti.

szText
[in] Specifica l'etichetta di testo del pulsante della barra degli strumenti.

bShowText
[in] Se questo parametro è TRUE, il framework mostra l'etichetta di testo. In caso contrario, il framework nasconde l'etichetta di testo.

bShowImage
[in] Se questo parametro è TRUE, il framework mostra l'immagine del pulsante della barra degli strumenti. In caso contrario, il framework nasconde l'immagine del pulsante della barra degli strumenti.

Osservazioni:

Per impostazione predefinita, il framework mostra le immagini dei pulsanti della barra degli strumenti, ma non mostra l'etichetta di testo dei pulsanti della barra degli strumenti.

Nelle compilazioni di debug questo metodo genera un errore di asserzione se nBtnIndex non si fa riferimento a un pulsante della barra degli strumenti valido o il pulsante della barra degli strumenti è un separatore.

`CMFCToolBar::SetTwoRowsWithSibling`

Posiziona la barra degli strumenti e il relativo elemento di pari livello su righe separate.

void SetTwoRowsWithSibling();

Osservazioni:

Il framework chiama questo metodo quando l'utente seleziona il pulsante Mostra pulsanti in due righe .

Chiamare il CMFCToolBar::SetSiblingToolBar metodo per abilitare i pulsanti Mostra pulsanti in una riga o Mostra pulsanti su due righe . Se si chiama CMFCToolBar::SetSiblingToolBar questa barra degli strumenti, la barra degli strumenti di pari livello viene spostata in una riga separata. In caso contrario, questa barra degli strumenti viene spostata in una riga separata.

Il framework chiama il CMFCToolBar::SetOneRowWithSibling metodo quando l'utente seleziona il pulsante Mostra pulsanti in una riga .

`CMFCToolBar::SetUserImages`

Imposta la raccolta di immagini definite dall'utente nell'applicazione.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

Parametri

pUserImages
[in] Puntatore alla raccolta di immagini definite dall'utente.

Valore restituito

Diverso da zero se il metodo ha esito positivo; in caso contrario, 0 se l'oggetto specificato CMFCToolBarImages non è valido o ha una dimensione dell'immagine diversa dalle dimensioni predefinite dell'immagine della barra degli strumenti.

Osservazioni:

Il framework usa immagini definite dall'utente per disegnare pulsanti della barra degli strumenti personalizzati dall'utente. L'elenco di immagini specificato da pUserImages è condiviso tra tutte le barre degli strumenti dell'applicazione.

Questo metodo genera un errore di asserzione nelle compilazioni debug se l'oggetto specificato CMFCToolBarImages non è valido o ha una dimensione dell'immagine diversa dalle dimensioni predefinite dell'immagine della barra degli strumenti.

Gli esempi di OutlookDemo, ToolTipDemo e VisualStudioDemo usano questo metodo per impostare la raccolta globale di immagini definite dall'utente. Caricano il file denominato UserImages.bmp, che si trova nella directory di lavoro dell'applicazione.

Chiamare il metodo 'CMFCToolBar::GetUserImages per recuperare la raccolta di immagini definite dall'utente nell'applicazione.

`CMFCToolBar::StretchPane`

Estende la barra degli strumenti verticalmente o orizzontalmente e riposiziona i pulsanti, se necessario.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parametri

nLength
[in] Quantità, espressa in pixel, in base alla quale estendere il riquadro.

bVert
[in] Se TRUE, estende il riquadro verticalmente. Se FALSE, estende il riquadro orizzontalmente.

Valore restituito

Oggetto CSize che specifica le dimensioni dell'area client della barra degli strumenti.

Osservazioni:

Questo metodo chiama CMFCToolBar::WrapToolBar per riposizionare i pulsanti all'interno della barra degli strumenti estesa.

Il valore restituito viene determinato chiamando CMFCToolBar::CalcSize.

`CMFCToolBar::TranslateChar`

Esegue un comando button se il codice del tasto specificato corrisponde a un tasto di scelta rapida valido.

virtual BOOL TranslateChar(UINT nChar);

Parametri

nChar
[in] Specifica un codice di chiave virtuale. Per un elenco dei codici di chiave virtuale standard, vedere Winuser.h

Valore restituito

FALSE se il codice del tasto specificato non è stampabile o non corrisponde a una scelta rapida da tastiera valida; TRUE se il codice della chiave specificato corrisponde a un'opzione di menu a discesa; in caso contrario, il valore restituito da CMFCToolBar::ProcessCommand.

Osservazioni:

Il framework chiama questo metodo quando viene premuto un tasto insieme al tasto ALT .

`CMFCToolBar::UpdateButton`

Aggiorna lo stato del pulsante specificato.

void UpdateButton(int nIndex);

Parametri

nIndex
[in] Specifica l'indice in base zero del pulsante da aggiornare.

Osservazioni:

`CMFCToolBar::WrapToolBar`

Riposiziona i pulsanti della barra degli strumenti all'interno delle dimensioni specificate.

int WrapToolBar(
    int nWidth,
    int nHeight = 32767,
    CDC* pDC = NULL,
    int nColumnWidth = -1,
    int nRowHeight = -1);

Parametri

nWidth
[in] Larghezza massima della barra degli strumenti.

nHeight
[in] Altezza massima della barra degli strumenti. Non utilizzato se la barra degli strumenti è mobile.

pDC
[in] Puntatore a un contesto di dispositivo. Se NULL, viene usato il contesto del dispositivo per la barra degli strumenti.

nColumnWidth
[in] Larghezza pulsante. Se -1, viene utilizzata la larghezza corrente.

[in] m nRowHeight Altezza pulsante. Se -1, viene usata l'altezza corrente.

Valore restituito

Numero di righe di pulsanti sulla barra degli strumenti.

Osservazioni:

Questo metodo riposiziona i pulsanti all'interno della barra degli strumenti, eseguendo il wrapping dei pulsanti in righe aggiuntive, se necessario.

`CMFCToolBar::m_bDontScaleImages`

Specifica se ridimensionare o meno le immagini della barra degli strumenti in modalità DPI elevato. Impostare su per TRUE impedire il ridimensionamento delle immagini quando le dimensioni di un'immagine non corrispondono a una dimensione del pulsante.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

Vedi anche

Grafico della gerarchia
Classi
CMFCMenuBar Classe
CMFCPopupMenuBar Classe
CMFCDropDownToolBar Classe
Procedura dettagliata: inserimento di controlli nelle barre degli strumenti

Condividi tramite

Classe CMFCToolBar

Sintassi

Membri

Costruttori pubblici

Metodi pubblici

Metodi protetti

Membri dei dati

Osservazioni:

Esempio

Requisiti

Gerarchia di ereditarietà

CMFCToolBar::AddBasicCommand

Parametri

Osservazioni:

CMFCToolBar::AddCommandUsage

Parametri

Osservazioni:

CMFCToolBar::AddToolBarForImageCollection

Parametri

Valore restituito

Osservazioni:

CMFCToolBar::AdjustLayout

Osservazioni:

CMFCToolBar::AdjustSize

Osservazioni:

CMFCToolBar::AllowChangeTextLabels

Valore restituito

Osservazioni:

CMFCToolBar::AllowShowOnList

Valore restituito

Osservazioni:

CMFCToolBar::AreTextLabels

Valore restituito

Osservazioni:

CMFCToolBar::AutoGrayInactiveImages

Parametri

Osservazioni:

CMFCToolBar::ButtonToIndex

Parametri

Valore restituito

CMFCToolBar::CalcFixedLayout

Parametri

Valore restituito

Osservazioni:

CMFCToolBar::CalcMaxButtonHeight

Valore restituito

Osservazioni:

CMFCToolBar::CalcSize

Parametri

Valore restituito

Osservazioni:

CMFCToolBar::CanBeClosed

Valore restituito

Osservazioni:

CMFCToolBar::CanBeRestored

Valore restituito

Osservazioni:

CMFCToolBar::CanFocus

Valore restituito

Osservazioni:

CMFCToolBar::CanHandleSiblings

Valore restituito

Osservazioni:

CMFCToolBar::CleanUpImages

Osservazioni:

CMFCToolBar::CleanUpLockedImages

Osservazioni:

CMFCToolBar::CommandToIndex

Parametri

Valore restituito

Osservazioni:

CMFCToolBar::Create

Parametri

Valore restituito

Osservazioni:

CMFCToolBar::CreateEx

Parametri

Valore restituito

Osservazioni:

Classe `CMFCToolBar`

`CMFCToolBar::AddBasicCommand`

`CMFCToolBar::AddCommandUsage`

`CMFCToolBar::AddToolBarForImageCollection`

`CMFCToolBar::AdjustLayout`

`CMFCToolBar::AdjustSize`

`CMFCToolBar::AllowChangeTextLabels`

`CMFCToolBar::AllowShowOnList`

`CMFCToolBar::AreTextLabels`

`CMFCToolBar::AutoGrayInactiveImages`

`CMFCToolBar::ButtonToIndex`

`CMFCToolBar::CalcFixedLayout`

`CMFCToolBar::CalcMaxButtonHeight`

`CMFCToolBar::CalcSize`

`CMFCToolBar::CanBeClosed`

`CMFCToolBar::CanBeRestored`

`CMFCToolBar::CanFocus`

`CMFCToolBar::CanHandleSiblings`

`CMFCToolBar::CleanUpImages`

`CMFCToolBar::CleanUpLockedImages`

`CMFCToolBar::CommandToIndex`

`CMFCToolBar::Create`

`CMFCToolBar::CreateEx`

`CMFCToolBar::Deactivate`

`CMFCToolBar::DoPaint`

`CMFCToolBar::DrawButton`

`CMFCToolBar::DrawSeparator`

`CMFCToolBar::EnableCustomizeButton`

`CMFCToolBar::EnableDocking`

`CMFCToolBar::EnableLargeIcons`

`CMFCToolBar::EnableQuickCustomization`

`CMFCToolBar::EnableReflections`

`CMFCToolBar::EnableTextLabels`

`CMFCToolBar::FromHandlePermanent`

`CMFCToolBar::GetAllButtons`

`CMFCToolBar::GetAllToolbars`

`CMFCToolBar::GetBasicCommands`

`CMFCToolBar::GetButton`

`CMFCToolBar::GetButtonInfo`

`CMFCToolBar::GetButtonSize`

`CMFCToolBar::GetButtonStyle`

`CMFCToolBar::GetButtonText`

`CMFCToolBar::GetColdImages`

`CMFCToolBar::GetColumnWidth`

`CMFCToolBar::GetCommandButtons`

`CMFCToolBar::GetCount`