Condividi tramite


Classe CMFCToolBar

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:

  1. Aggiungere un CMFCToolBar oggetto alla finestra cornice principale.

  2. 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.

  3. 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à

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

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;

Parametri

nIndex
[in] Indice di un pulsante della barra degli strumenti.

rString
[out] Testo dell'etichetta del pulsante della barra degli strumenti.

Valore restituito

Testo dell'etichetta del pulsante della barra degli strumenti.

Osservazioni:

Chiamare CMFCToolBar::SetButtonText o CMFCToolBar::SetToolBarBtnText per impostare l'etichetta di testo.

CMFCToolBar::GetColdImages

Restituisce un puntatore all'insieme di immagini del pulsante della barra degli strumenti ad accesso sporadico nell'applicazione.

static CMFCToolBarImages* GetColdImages();

Valore restituito

Puntatore alla raccolta di immagini del pulsante della barra degli strumenti ad accesso sporadico.

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 o CMFCToolBar::LoadBitmap per caricare le immagini ad accesso sporadico.

CMFCToolBar::GetColumnWidth

Restituisce la larghezza dei pulsanti della barra degli strumenti.

virtual int GetColumnWidth() const;

Valore restituito

Valore che specifica la larghezza dei pulsanti della barra degli strumenti.

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 una larghezza di colonna diversa per la barra degli strumenti.

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

uiID
[in] Specifica l'ID comando del pulsante.

Valore restituito

Indice dell'immagine della barra degli strumenti nell'elenco condiviso di immagini.

Osservazioni:

Utilizzare questo metodo condiviso per recuperare l'indice dell'immagine predefinita per un pulsante della barra degli strumenti con l'ID comando specificato. Il valore restituito è un indice nella raccolta condivisa di immagini del pulsante della barra degli strumenti per tutte le barre degli strumenti nell'applicazione. Chiamare il CMFCToolBar::GetImages metodo per ottenere un puntatore a questa raccolta.

CMFCToolBar::GetDisabledImages

Restituisce un puntatore alla raccolta di immagini utilizzate per i pulsanti della barra degli strumenti disabilitati nell'applicazione.

static CMFCToolBarImages* __stdcall GetDisabledImages();

Valore restituito

Puntatore alla raccolta di immagini del pulsante della barra degli strumenti disabilitate.

Osservazioni:

Caricare le immagini del pulsante della barra degli strumenti disabilitate usando i CMFCToolBarEditBoxButton metodi Class e CMFCToolBar::LoadBitmap .

CMFCToolBar::GetDisabledMenuImages

Restituisce un puntatore all'insieme di immagini utilizzate per i pulsanti di menu disabilitati nell'applicazione.

static CMFCToolBarImages* __stdcall GetDisabledMenuImages();

Valore restituito

Puntatore alla raccolta di immagini di menu disabilitate.

Osservazioni:

Caricare le immagini disabilitate usando il CMFCToolBarEditBoxButton metodo Class .

CMFCToolBar::GetDroppedDownMenu

Recupera un puntatore all'oggetto pulsante di menu che attualmente visualizza il relativo sottomenu.

CMFCToolBarMenuButton* GetDroppedDownMenu(int* pIndex = NULL) const;

Parametri

pIndex
[out] Riceve l'indice del pulsante nella raccolta di pulsanti della barra degli strumenti.

Valore restituito

Puntatore all'oggetto pulsante di menu che visualizza il sottomenu o NULL se non viene visualizzato alcun menu.

Osservazioni:

Se questo metodo restituisce un valore non Null e pIndex non NULLè , il valore a cui pIndex punta viene impostato sull'indice del pulsante di menu nell'insieme di pulsanti della barra degli strumenti.

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.

BOOL GetGrayDisabledButtons() const;

Valore restituito

TRUE per dimare le immagini dei pulsanti disabilitati; FALSE per ottenere immagini dalla raccolta di immagini disabilitate.

Osservazioni:

Usare CMFCToolBar::SetGrayDisabledButtons per passare da immagini in grigio alle immagini dalla raccolta di immagini disabilitate.

CMFCToolBar::GetHighlightedButton

Restituisce un puntatore al pulsante della barra degli strumenti attualmente evidenziato.

CMFCToolBarButton* GetHighlightedButton() const;

Valore restituito

Puntatore a un oggetto pulsante della barra degli strumenti; o NULL se non è evidenziato alcun pulsante.

Osservazioni:

Un pulsante della barra degli strumenti è evidenziato se ha lo stato attivo della tastiera. Un pulsante della barra degli strumenti è evidenziato anche se i pulsanti della barra degli strumenti sono attivati in questa applicazione (per altre informazioni, vedere CMFCToolBar::GetHotBorder e CMFCToolBar::SetHotBorder) e il mouse punta su di esso quando nessun pulsante della barra degli strumenti o voce di menu ha lo stato attivo della tastiera.

CMFCToolBar::GetHotBorder

Determina se i pulsanti della barra degli strumenti sono attivati. Se un pulsante viene rilevato a caldo, viene evidenziato quando il mouse si sposta su di esso.

BOOL GetHotBorder() const;

Valore restituito

TRUE se i pulsanti della barra degli strumenti sono a caldo; in caso contrario, FALSE.

Osservazioni:

Per impostazione predefinita, i pulsanti della barra degli strumenti sono attivati.

CMFCToolBar::GetHotTextColor

Restituisce il colore del testo dei pulsanti della barra degli strumenti evidenziati.

static COLORREF GetHotTextColor();

Valore restituito

Valore COLORREF che rappresenta il colore del testo evidenziato corrente.

Osservazioni:

Chiamare CMFCToolBar::SetHotTextColor per impostare un nuovo colore di testo per i 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.

HWND GetHwndLastFocus() const;

Valore restituito

Handle per la finestra non derivata da CMFCBaseToolBar Classe, che in precedenza aveva lo stato attivo per l'input o NULL se non esiste una finestra di questo tipo.

Osservazioni:

Quando un CMFCToolBar controllo riceve lo stato attivo per l'input, archivia un handle nella finestra che ha perso lo stato attivo in modo che possa ripristinarlo in un secondo momento.

CMFCToolBar::GetIgnoreSetText

Specifica se le chiamate per impostare le etichette dei pulsanti vengono ignorate.

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.

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 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.

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.

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.

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 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