Classe CMFCRibbonBar

La classe CMFCRibbonBar implementa una barra multifunzione analoga a quella usata in Office 2007.

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

Sintassi

class CMFCRibbonBar : public CPane

Membri

Costruttori pubblici

Nome Descrizione
CMFCRibbonBar::CMFCRibbonBar Costruttore predefinito.

Metodi pubblici

Nome Descrizione
CMFCRibbonBar::ActivateContextCategory Attiva una categoria contesto già visibile.
CMFCRibbonBar::AddCategory Aggiunge una nuova categoria della barra multifunzione alla barra multifunzione.
CMFCRibbonBar::AddContextCategory Aggiunge una categoria contesto.
CMFCRibbonBar::AddMainCategory Aggiunge una nuova categoria principale della barra multifunzione.
CMFCRibbonBar::AddPrintPreviewCategory
CMFCRibbonBar::AddQATOnlyCategory
CMFCRibbonBar::AddToTabs Aggiunge un elemento della barra multifunzione al lato destro di una barra multifunzione.
CMFCRibbonBar::CreateEx Crea una barra di controllo e la collega all'oggetto CPane . Esegue l'override di CPane::CreateEx.
CMFCRibbonBar::Create Crea un controllo della barra multifunzione e lo collega a una barra multifunzione.
CMFCRibbonBar::DeactivateKeyboardFocus
CMFCRibbonBar::DrawMenuImage
CMFCRibbonBar::DWMCompositionChanged
CMFCRibbonBar::EnableKeyTips Abilita o disabilita i suggerimenti tasto di scelta per il controllo della barra multifunzione.
CMFCRibbonBar::EnablePrintPreview Abilitare la scheda Anteprima di stampa.
CMFCRibbonBar::EnableToolTips Abilita o disabilita le descrizioni comando sulla barra multifunzione.
CMFCRibbonBar::FindByData Trova un elemento della barra multifunzione usando i dati specificati da un utente.
CMFCRibbonBar::FindByID Trova un elemento della barra multifunzione con l'ID comando specificato.
CMFCRibbonBar::FindCategoryIndexByData Trova l'indice della categoria della barra multifunzione che contiene i dati definiti dall'utente.
CMFCRibbonBar::ForceRecalcLayout
CMFCRibbonBar::GetActiveCategory Ottiene un puntatore per una categoria attiva.
CMFCRibbonBar::GetCaptionHeight Restituisce l'altezza della didascalia. Esegue l'override di CBasePane::GetCaptionHeight.
CMFCRibbonBar::GetCategory Ottiene il puntatore a una categoria che si trova in corrispondenza dell'indice specificato.
CMFCRibbonBar::GetCategoryCount Ottiene il numero delle categorie della barra multifunzione nella barra multifunzione.
CMFCRibbonBar::GetCategoryHeight
CMFCRibbonBar::GetCategoryIndex Restituisce l'indice di una categoria della barra multifunzione.
CMFCRibbonBar::GetContextName Recupera il nome della didascalia della categoria contesto specificata mediante un ID.
CMFCRibbonBar::GetDroppedDown
CMFCRibbonBar::GetElementsByID Ottiene una matrice che contiene i puntatori a tutti gli elementi della barra multifunzione con l'ID specificato.
CMFCRibbonBar::GetApplicationButton Ottiene un puntatore a un pulsante della barra multifunzione.
CMFCRibbonBar::GetFocused Restituisce un elemento con stato attivo.
CMFCRibbonBar::GetHideFlags
CMFCRibbonBar::GetItemIDsList
CMFCRibbonBar::GetKeyboardNavigationLevel
CMFCRibbonBar::GetKeyboardNavLevelCurrent
CMFCRibbonBar::GetKeyboardNavLevelParent
CMFCRibbonBar::GetMainCategory Restituisce un puntatore alla categoria della barra multifunzione attualmente selezionata.
CMFCRibbonBar::GetQATCommandsLocation
CMFCRibbonBar::GetQATDroppedDown
CMFCRibbonBar::GetQuickAccessCommands Compila un elenco che include gli ID di comando di tutti gli elementi visualizzati sulla barra di accesso rapido.
CMFCRibbonBar::GetQuickAccessToolbarLocation
CMFCRibbonBar::GetTabTrancateRatio
CMFCRibbonBar::GetTooltipFixedWidthLargeImage
CMFCRibbonBar::GetTooltipFixedWidthRegular
CMFCRibbonBar::GetVisibleCategoryCount
CMFCRibbonBar::HideAllContextCategories Nasconde tutte le categorie attive e visibili.
CMFCRibbonBar::HideKeyTips
CMFCRibbonBar::HitTest Trova un puntatore all'elemento della barra multifunzione che si trova nel punto specificato nelle coordinate client della barra multifunzione.
CMFCRibbonBar::IsKeyTipEnabled Determina se i suggerimenti tasto di scelta sono abilitati.
CMFCRibbonBar::IsMainRibbonBar
CMFCRibbonBar::IsPrintPreviewEnabled Determina se la scheda Anteprima di stampa è abilitata.
CMFCRibbonBar::IsQATEmpty
CMFCRibbonBar::IsQuickAccessToolbarOnTop Specifica se la barra di accesso rapido è posizionata sopra la barra multifunzione.
CMFCRibbonBar::IsReplaceFrameCaption Determina se la barra multifunzione sostituisce la didascalia del frame principale o viene aggiunta sotto la didascalia del frame.
CMFCRibbonBar::IsShowGroupBorder
CMFCRibbonBar::IsToolTipDescrEnabled Determina se le descrizioni dei comandi sono abilitate.
CMFCRibbonBar::IsToolTipEnabled Determina se le descrizioni dei comandi per la barra multifunzione sono abilitate.
CMFCRibbonBar::IsTransparentCaption
CMFCRibbonBar::IsWindows7Look Indica se la barra multifunzione ha un aspetto in stile Windows 7 (piccolo pulsante di applicazione rettangolare).
CMFCRibbonBar::LoadFromResource Con overload. Carica una barra multifunzione dalle risorse dell'applicazione.
CMFCRibbonBar::OnClickButton
CMFCRibbonBar::OnEditContextMenu
CMFCRibbonBar::OnRTLChanged Esegue l'override di CPane::OnRTLChanged.
CMFCRibbonBar::OnSetAccData Esegue l'override di CBasePane::OnSetAccData.
CMFCRibbonBar::OnShowRibbonContextMenu
CMFCRibbonBar::OnShowRibbonQATMenu
CMFCRibbonBar::OnSysKeyDown
CMFCRibbonBar::OnSysKeyUp
CMFCRibbonBar::PopTooltip
CMFCRibbonBar::PreTranslateMessage Esegue l'override di CBasePane::PreTranslateMessage.
CMFCRibbonBar::RecalcLayout Esegue l'override di CPane::RecalcLayout.
CMFCRibbonBar::RemoveAllCategories Rimuove tutte le categorie della barra multifunzione dalla barra multifunzione.
CMFCRibbonBar::RemoveAllFromTabs Rimuove tutti gli elementi della barra multifunzione dall'area della scheda.
CMFCRibbonBar::RemoveCategory Rimuove la categoria della barra multifunzione che si trova in corrispondenza dell'indice specificato.
CMFCRibbonBar::SaveToXMLBuffer Salva la barra multifunzione in un buffer.
CMFCRibbonBar::SaveToXMLFile Salva la barra multifunzione in un file XML.
CMFCRibbonBar::SetActiveCategory Imposta una categoria specificata della barra multifunzione su attiva.
CMFCRibbonBar::SetActiveMDIChild
CMFCRibbonBar::SetElementKeys Imposta i suggerimenti tasto di scelta specificati per tutti gli elementi della barra multifunzione con ID di comando specificato.
CMFCRibbonBar::SetApplicationButton Assegna un pulsante della barra multifunzione dell'applicazione alla barra multifunzione.
CMFCRibbonBar::SetKeyboardNavigationLevel
CMFCRibbonBar::SetMaximizeMode
CMFCRibbonBar::SetQuickAccessCommands Aggiunge uno o più elementi della barra multifunzione alla barra di accesso rapido.
CMFCRibbonBar::SetQuickAccessDefaultState Specifica lo stato predefinito per la barra di accesso rapido.
CMFCRibbonBar::SetQuickAccessToolbarOnTop Posiziona la barra di accesso rapido sopra o sotto la barra multifunzione.
CMFCRibbonBar::SetTooltipFixedWidth
CMFCRibbonBar::SetWindows7Look Abilita/Disabilita l'aspetto in stile Windows 7 della barra multifunzione (piccolo pulsante di applicazione rettangolare).
CMFCRibbonBar::ShowCategory Mostra o nasconde la categoria specificata della barra multifunzione.
CMFCRibbonBar::ShowContextCategories Mostra o nasconde le categorie contesto con l'ID specificato.
CMFCRibbonBar::ShowKeyTips
CMFCRibbonBar::ToggleMimimizeState Visualizza la barra multifunzione ridotta a icona e ingrandita e viceversa.
CMFCRibbonBar::TranslateChar

Osservazioni:

Microsoft ha presentato la barra multifunzione di Office Fluent contemporaneamente al rilascio di Microsoft Office 2007. Questa barra multifunzione non è solo un nuovo controllo. Rappresenta un nuovo paradigma dell'interfaccia utente. La barra multifunzione è in riquadro che include una serie di schede definite categorie. Ogni categoria è suddivisa logicamente in pannelli della barra multifunzione e ogni pannello può contenere diversi controlli e pulsanti di comando.

Gli elementi visualizzati sulla barra multifunzione si espandono e comprimono per usare al meglio lo spazio disponibile. Ad esempio, se lo spazio disponibile per la visualizzazione degli elementi di un pannello della barra multifunzione non è sufficiente, diventerà un pulsante di menu che visualizza elementi secondari in un menu a comparsa. La barra multifunzione si comporta come una barra di controllo statica (non mobile) e può essere ancorata nella parte superiore di un frame.

È possibile usare la classe CMFCRibbonStatusBar per implementare una barra di stato analoga a quella usata in Office 2007. Una categoria della barra multifunzione contiene (e visualizza) un gruppo di pannelli della barra multifunzione. Ogni pannello della barra multifunzione contiene uno o più elementi della barra multifunzione, derivati da CMFCRibbonBaseElement.

Per informazioni su come aggiungere una barra multifunzione all'applicazione MFC esistente, vedere Procedura dettagliata: Aggiornamento dell'applicazione MFC Scribble.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCRibbonBar

Requisiti

Intestazione: afxribbonbar.h

CMFCRibbonBar::ActivateContextCategory

Attiva una categoria contesto già visibile.

BOOL ActivateContextCategory(UINT uiContextID);

Parametri

uiContextID
[in] ID categoria contesto.

Valore restituito

TRUE se viene trovata e attivata una categoria di contesto con uiContextID ; in caso contrario FALSE, .

CMFCRibbonBar::AddCategory

Crea e inizializza una nuova categoria della barra multifunzione per la barra multifunzione.

CMFCRibbonCategory* AddCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage= CSize(16,
    16),
    CSize sizeLargeImage= CSize(32,
    32),
    int nInsertAt = -1,
    CRuntimeClass* pRTI= NULL);

Parametri

lpszName
[in] Nome della categoria della barra multifunzione.

uiSmallImagesResID
[in] ID risorsa dell'elenco di immagini di piccole dimensioni per la categoria della barra multifunzione.

uiLargeImagesResID
[in] ID risorsa dell'elenco di immagini di grandi dimensioni per la categoria della barra multifunzione.

sizeSmallImage
[in] Specifica le dimensioni delle immagini di piccole dimensioni per la categoria della barra multifunzione.

sizeLargeImage
[in] Specifica le dimensioni delle immagini di grandi dimensioni per la categoria della barra multifunzione.

nInsertAt
[in] Indice in base zero della posizione della categoria.

pRTI
[in] Puntatore a una CMFCRibbonCategory classe di runtime della classe per creare dinamicamente una categoria della barra multifunzione in fase di esecuzione.

Valore restituito

Puntatore alla nuova categoria della barra multifunzione se il metodo ha avuto esito positivo; in caso contrario, NULL.

Osservazioni:

Se il pRTI parametro non NULLè , la nuova categoria della barra multifunzione viene creata in modo dinamico usando la classe di runtime.

Esempio

Nell'esempio seguente viene illustrato come usare il AddCategory metodo nella CMFCRibbonBar classe .

// Add "Home" category.
// CMFCRibbonBar m_wndRibbonBar
strTemp.LoadString(IDS_RIBBON_HOME);
CMFCRibbonCategory *pCategoryHome = m_wndRibbonBar.AddCategory(strTemp,
                                                               IDB_WRITESMALL, IDB_WRITELARGE);

CMFCRibbonBar::AddContextCategory

Crea e inizializza una nuova categoria di contesto per la barra multifunzione.

CMFCRibbonCategory* AddContextCategory(
    LPCTSTR lpszName,
    LPCTSTR lpszContextName,
    UINT uiContextID,
    AFX_RibbonCategoryColor clrContext,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32),
    CRuntimeClass* pRTI = NULL);

Parametri

lpszName
[in] Nome della categoria.

lpszContextName
[in] Nome della didascalia della categoria di contesto.

uiContextID
[in] ID contesto.

clrContext
[in] Colore della didascalia della categoria di contesto.

uiSmallImagesResID
[in] ID risorsa dell'immagine piccola di una categoria di contesto.

uiLargeImagesResID
[in] ID risorsa dell'immagine di grandi dimensioni di una categoria di contesto.

sizeSmallImage
[in] Dimensioni di un'immagine di piccole dimensioni.

sizeLargeImage
[in] Dimensioni di un'immagine di grandi dimensioni.

pRTI
[in] Puntatore a una classe di runtime.

Valore restituito

Puntatore alla categoria appena creata o NULL se il CreateObject metodo di pRTI non può creare la categoria specificata.

Osservazioni:

Usare questa funzione per aggiungere una categoria di contesto. Le categorie di contesto sono un tipo speciale di categoria che può essere visualizzato o nascosto in fase di esecuzione, a seconda del contesto dell'applicazione corrente. Ad esempio, quando l'utente seleziona un oggetto, è possibile visualizzare schede speciali con categorie di contesto, usate per modificare l'oggetto selezionato specifico.

Il colore di una categoria di contesto può essere uno dei valori seguenti:

  • AFX_CategoryColor_None

  • AFX_CategoryColor_Red

  • AFX_CategoryColor_Orange

  • AFX_CategoryColor_Yellow

  • AFX_CategoryColor_Green

  • AFX_CategoryColor_Blue

  • AFX_CategoryColor_Indigo

  • AFX_CategoryColor_Violet

CMFCRibbonBar::AddMainCategory

Crea una nuova categoria della barra multifunzione principale per la barra multifunzione.

CMFCRibbonMainPanel* AddMainCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    UINT uiLargeImagesResID,
    CSize sizeSmallImage = CSize(16,
    16),
    CSize sizeLargeImage = CSize(32,
    32));

Parametri

lpszName
[in] Nome della categoria della barra multifunzione principale.

uiSmallImagesResID
[in] ID risorsa di immagini di piccole dimensioni.

uiLargeImagesResID
[in] ID risorsa di immagini di grandi dimensioni.

sizeSmallImage
[in] Dimensioni delle immagini di piccole dimensioni.

sizeLargeImage
[in] Dimensioni delle immagini di grandi dimensioni.

Valore restituito

Puntatore alla nuova categoria della barra multifunzione principale se il metodo ha avuto esito positivo; in caso contrario, NULL.

Osservazioni:

Se esiste già una categoria principale della barra multifunzione, viene eliminata.

Esempio

Nell'esempio seguente viene illustrato come usare il AddMainCategory metodo nella CMFCRibbonBar classe .

// m_wndRibbonBar is declared as a protected member variable
// CMFCRibbonBar m_wndRibbonBar.
// strTemp is a CString variable.
strTemp.LoadString(IDS_RIBBON_FILE);
CMFCRibbonMainPanel *pMainPanel = m_wndRibbonBar.AddMainCategory(strTemp,
                                                                 IDB_FILESMALL, IDB_FILELARGE);

CMFCRibbonBar::AddPrintPreviewCategory

Crea una categoria di anteprima di stampa sulla barra multifunzione.

CMFCRibbonCategory* AddPrintPreviewCategory();

Valore restituito

Puntatore alla nuova categoria della barra multifunzione se il metodo ha avuto esito positivo; in caso contrario, NULL.

Osservazioni:

Questo metodo crea una categoria della barra multifunzione e i controlli necessari per fornire un'anteprima di stampa.

CMFCRibbonBar::AddQATOnlyCategory

Crea una categoria della barra multifunzione di accesso rapido.

CMFCRibbonCategory* AddQATOnlyCategory(
    LPCTSTR lpszName,
    UINT uiSmallImagesResID,
    CSize sizeSmallImage = CSize(16,
    16));

Parametri

lpszName
[in] Nome della categoria.

uiSmallImagesResID
[in] ID risorsa dell'elenco di immagini per la categoria.

sizeSmallImage
[in] Dimensioni delle immagini per gli elementi della barra multifunzione nella categoria.

Valore restituito

Puntatore alla nuova categoria se il metodo ha avuto esito positivo; in caso contrario, NULL.

Osservazioni:

La categoria della barra multifunzione di accesso rapido viene usata solo nella finestra di dialogo di personalizzazione della barra degli strumenti di accesso rapido.

CMFCRibbonBar::AddToTabs

Aggiunge l'elemento della barra multifunzione specificato alla riga delle schede della barra multifunzione.

void AddToTabs(CMFCRibbonBaseElement* pElement);

Parametri

pElement
[in] Puntatore a un elemento della barra multifunzione.

Osservazioni:

L'elemento della barra multifunzione viene posizionato prima di qualsiasi pulsante di sistema.

CMFCRibbonBar::CMFCRibbonBar

Costruisce e inizializza un oggetto CMFCRibbonBar.

CMFCRibbonBar(BOOL bReplaceFrameCaption = TRUE);

Parametri

bReplaceFrameCaption
[in] TRUE per la barra multifunzione per sostituire la didascalia della finestra cornice principale; FALSE per individuare la barra multifunzione sotto la didascalia della finestra cornice principale.

Osservazioni:

CMFCRibbonBar::Create

Crea una finestra per la barra multifunzione.

BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parametri

pParentWnd
[in] Puntatore alla finestra padre per la barra multifunzione.

dwStyle
[in] Combinazione logica di stili per la nuova finestra.

nID
[in] ID della nuova finestra.

Valore restituito

TRUE se la finestra è stata creata; in caso contrario FALSE, .

Osservazioni:

Esempio

Nell'esempio seguente viene illustrato come usare il Create metodo della CMFCRibbonBar classe .

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.Create(this, WS_CHILD | CBRS_TOP);

CMFCRibbonBar::CreateEx

Crea una finestra per la barra multifunzione.

BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = 0,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_RIBBON_BAR);

Parametri

pParentWnd
[in] Puntatore alla finestra padre per la barra multifunzione.

dwCtrlStyle
[in] Questo parametro non viene usato.

dwStyle
[in] Combinazione logica di stili per la nuova finestra.

nID
[in] ID della nuova finestra.

Valore restituito

TRUE se la finestra è stata creata; in caso contrario FALSE, .

Osservazioni:

CMFCRibbonBar::DeactivateKeyboardFocus

Chiude tutti i controlli descrizione comando sulla barra multifunzione.

void DeactivateKeyboardFocus(BOOL bSetFocus = TRUE);

Parametri

bSetFocus
[in] TRUE per impostare lo stato attivo sulla finestra padre della barra multifunzione.

Osservazioni:

CMFCRibbonBar::DrawMenuImage

Disegna l'immagine per un pulsante di menu.

BOOL DrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuItem,
    const CRect& rectImage);

Parametri

pDC
[in] Puntatore a un contesto del dispositivo per il pulsante di menu.

pMenuItem
[in] Puntatore a un pulsante del menu della barra degli strumenti.

rectImage
[in] Rettangolo di visualizzazione per un pulsante di menu.

Valore restituito

TRUE se l'immagine è stata disegnata; in caso contrario FALSE, .

Osservazioni:

CMFCRibbonBar::DWMCompositionChanged

Regola la visualizzazione della barra multifunzione quando la composizione di Desktop Window Manager (DWM) è abilitata o disabilitata.

virtual void DWMCompositionChanged();

Osservazioni:

CMFCRibbonBar::EnableKeyTips

Abilita o disabilita la funzionalità di descrizione comando per la barra multifunzione.

void EnableKeyTips(BOOL bEnable = TRUE);

Parametri

bEnable
[in] TRUE per abilitare la funzionalità dei suggerimenti per i tasti; FALSE per disabilitare la funzionalità dei suggerimenti per i tasti.

Osservazioni:

Quando si abilita questa funzionalità, i suggerimenti per i tasti vengono visualizzati quando l'utente preme i tasti ALT o F10 . Quando l'utente preme ALT , i suggerimenti per i tasti vengono visualizzati con un ritardo di 200 millisecondi. Questo ritardo consente l'esecuzione dei tasti di scelta rapida in modo che il tasto ALT premuto non interferisca con altre combinazioni che includono il tasto ALT.

CMFCRibbonBar::EnablePrintPreview

Abilita o disabilita la funzionalità Anteprima di stampa.

void EnablePrintPreview(BOOL bEnable = TRUE);

Parametri

bEnable
[in] TRUE per abilitare la funzionalità Anteprima di stampa; FALSE per disabilitare la funzionalità Anteprima di stampa.

Osservazioni:

Se bEnable è FALSE e esiste una categoria di anteprima di stampa, viene eliminata.

Per impostazione predefinita, la funzionalità Anteprima di stampa è abilitata.

CMFCRibbonBar::EnableToolTips

Abilita o disabilita le descrizioni comando e le descrizioni delle descrizioni comando facoltative sulla barra multifunzione.

void EnableToolTips(
    BOOL bEnable = TRUE,
    BOOL bEnableDescr = TRUE);

Parametri

bEnable
[in] TRUE per abilitare le descrizioni comando sulla barra multifunzione; FALSE per disabilitare le descrizioni comando sulla barra multifunzione.

bEnableDescr
[in] TRUE per abilitare le descrizioni delle descrizioni comando nella descrizione comando; FALSE per disabilitare le descrizioni delle descrizioni comando nella descrizione comando.

Osservazioni:

Il bEnable parametro determina se le descrizioni comando vengono visualizzate quando il mouse passa il mouse su un elemento della barra multifunzione. Il bEnableDescr parametro determina se viene visualizzato testo descrittivo aggiuntivo con il testo della descrizione comando.

CMFCRibbonBar::FindByData

Recupera un puntatore a un elemento della barra multifunzione se dispone dei dati e della visibilità specificati.

CMFCRibbonBaseElement* FindByData(
    DWORD_PTR dwData,
    BOOL bVisibleOnly = TRUE) const;

Parametri

dwData
[in] Dati associati a un elemento della barra multifunzione.

bVisibleOnly
[in] TRUE per cercare solo gli elementi della barra multifunzione visibili; FALSE per cercare tutti gli elementi della barra multifunzione.

Valore restituito

Puntatore a un elemento della barra multifunzione se ha i dati e la visibilità specificati; in caso contrario NULL, .

Osservazioni:

Un elemento della barra multifunzione è qualsiasi controllo che è possibile aggiungere alla barra multifunzione, ad esempio un pulsante della barra multifunzione o una categoria della barra multifunzione o un dispositivo di scorrimento della barra multifunzione.

CMFCRibbonBar::FindByID

Recupera un puntatore all'elemento della barra multifunzione con l'ID comando e i valori di ricerca specificati.

CMFCRibbonBaseElement* FindByID(
    UINT uiCmdID,
    BOOL bVisibleOnly = TRUE,
    BOOL bExcludeQAT = FALSE) const;

Parametri

uiCmdID
[in] ID comando per un elemento della barra multifunzione.

bVisibleOnly
[in] TRUE per cercare solo gli elementi della barra multifunzione visibili; FALSE per cercare tutti gli elementi della barra multifunzione.

bExcludeQAT
[in] TRUE per escludere gli elementi della barra degli strumenti di accesso rapido dalla ricerca; in caso contrario, FALSE.

Valore restituito

Puntatore a un elemento della barra multifunzione se ha l'ID comando e i valori di ricerca specificati; in caso contrario, NULL.

Osservazioni:

Un elemento della barra multifunzione è qualsiasi controllo barra multifunzione che può essere aggiunto alla barra multifunzione, ad esempio un pulsante della barra multifunzione o una categoria della barra multifunzione o un dispositivo di scorrimento della barra multifunzione.

In generale, può essere presente più di un elemento della barra multifunzione con lo stesso ID comando. Se si desidera ottenere puntatori a tutti gli elementi della barra multifunzione che usano un ID comando specificato, usare il CMFCRibbonBar::GetElementsByID metodo .

CMFCRibbonBar::FindCategoryIndexByData

Recupera l'indice della categoria della barra multifunzione che contiene i dati specificati.

int FindCategoryIndexByData(DWORD dwData) const;

Parametri

dwData
[in] Dati associati a una categoria della barra multifunzione.

Valore restituito

Indice in base zero di una categoria della barra multifunzione se il metodo ha avuto esito positivo; in caso contrario -1.

CMFCRibbonBar::ForceRecalcLayout

Regola il layout di tutti gli elementi nella barra multifunzione e nella finestra padre e ridisegna l'intera finestra.

void ForceRecalcLayout();

Osservazioni:

CMFCRibbonBar::GetActiveCategory

Recupera un puntatore alla categoria della barra multifunzione attiva.

CMFCRibbonCategory* GetActiveCategory() const;

Valore restituito

Puntatore alla categoria della barra multifunzione attiva; o NULL se non è attiva alcuna categoria.

Osservazioni:

Una categoria è attiva se ha lo stato attivo. Per impostazione predefinita, la categoria attiva è la prima categoria a sinistra della barra multifunzione.

La categoria principale viene visualizzata quando l'utente preme il pulsante dell'applicazione e non può essere la categoria attiva.

CMFCRibbonBar::GetApplicationButton

Recupera un puntatore al pulsante dell'applicazione.

CMFCRibbonApplicationButton* GetApplicationButton() const;

Valore restituito

Puntatore al pulsante dell'applicazione; o NULL se il pulsante non è stato impostato.

CMFCRibbonBar::GetCaptionHeight

Recupera l'altezza dell'area della didascalia per la barra multifunzione.

int GetCaptionHeight() const;

Valore restituito

Altezza, in pixel, dell'area della didascalia per la barra multifunzione.

Osservazioni:

CMFCRibbonBar::GetCategory

Recupera un puntatore alla categoria della barra multifunzione in corrispondenza dell'indice specificato.

CMFCRibbonCategory* GetCategory(int nIndex) const;

Parametri

nIndex
[in] Indice in base zero di una categoria della barra multifunzione nell'elenco delle categorie della barra multifunzione contenute nella barra multifunzione.

Valore restituito

Puntatore alla categoria della barra multifunzione in corrispondenza dell'indice specificato; in caso contrario, NULL se nIndex non era compreso nell'intervallo.

CMFCRibbonBar::GetCategoryCount

Recupera il numero di categorie della barra multifunzione nella barra multifunzione.

int GetCategoryCount() const;

Valore restituito

Numero delle categorie della barra multifunzione nella barra multifunzione.

CMFCRibbonBar::GetCategoryHeight

Recupera l'altezza della categoria.

int GetCategoryHeight() const;

Valore restituito

Altezza della categoria.

Osservazioni:

L'altezza della categoria include l'altezza della scheda categoria.

CMFCRibbonBar::GetCategoryIndex

Recupera l'indice della categoria della barra multifunzione specificata.

int GetCategoryIndex(CMFCRibbonCategory* pCategory) const;

Parametri

pCategory
[in] Puntatore a una categoria della barra multifunzione.

Valore restituito

Indice in base zero di una categoria della barra multifunzione specificata da pCategory; o -1 se la categoria della barra multifunzione non viene trovata.

CMFCRibbonBar::GetContextName

Recupera il nome della didascalia della categoria di contesto specificata da un ID contesto.

BOOL GetContextName(
    UINT uiContextID,
    CString& strName) const;

Parametri

uiContextID
[in] ID del contesto della categoria della barra multifunzione.

strName
[out] Nome di una didascalia della categoria di contesto.

Valore restituito

TRUE se il metodo ha avuto esito positivo; in caso contrario, FALSE se uiContextID è stato zero o la didascalia della categoria di contesto non è stata trovata.

CMFCRibbonBar::GetDroppedDown

Recupera l'elemento della barra multifunzione attualmente eliminato.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Valore restituito

Elemento della barra multifunzione attualmente eliminato; o NULL se non viene eliminato alcun elemento della barra multifunzione.

Osservazioni:

CMFCRibbonBar::GetElementsByID

Recupera una matrice di puntatori a tutti gli elementi della barra multifunzione con un ID comando specifico.

void GetElementsByID(
    UINT uiCmdID,
    CArray<CMFCRibbonBaseElement*,CMFCRibbonBaseElement*>& arButtons);

Parametri

uiCmdID
[in] ID comando di un elemento della barra multifunzione.

arButtons
[out] Matrice di puntatori agli elementi della barra multifunzione.

Osservazioni:

Più elementi della barra multifunzione possono avere lo stesso ID comando perché alcuni elementi della barra multifunzione possono essere copiati nella barra degli strumenti di accesso rapido.

CMFCRibbonBar::GetHideFlags

Recupera i flag che indicano la quantità di barra multifunzione visibile.

DWORD GetHideFlags() const;

Valore restituito

Flag che indicano la quantità di barra multifunzione visibile.

Osservazioni:

La tabella seguente elenca la possibile combinazione di flag per il valore restituito:

Flag Descrizione
AFX_RIBBONBAR_HIDE_ELEMENTS La barra multifunzione è ridotta a icona verticalmente e sono visibili solo le schede delle categorie, il pulsante principale e la barra degli strumenti di accesso rapido.
AFX_RIBBONBAR_HIDE_ALL La larghezza della barra multifunzione è inferiore alla larghezza minima ed è completamente nascosta.

CMFCRibbonBar::GetItemIDsList

Recupera gli ID comando per la raccolta specificata di elementi della barra multifunzione sulla barra multifunzione.

void GetItemIDsList(CList<UINT, UINT>& lstItems,
    BOOL bHiddenOnly = FALSE) const;

Parametri

lstItems
[out] Elenco di ID comando per gli elementi della barra multifunzione contenuti nella barra multifunzione.

bHiddenOnly
[in] TRUE per escludere gli elementi della barra multifunzione visualizzati; FALSE per includere tutti gli elementi della barra multifunzione nella barra multifunzione.

Osservazioni:

CMFCRibbonBar::GetKeyboardNavigationLevel

Recupera il livello di spostamento corrente quando l'utente preme i suggerimenti per i tasti contenuti sulla barra multifunzione.

int GetKeyboardNavigationLevel() const;

Valore restituito

Il livello di spostamento corrente quando l'utente preme i suggerimenti per i tasti contenuti sulla barra multifunzione. Nella tabella seguente sono elencati i possibili valori restituiti:

valore Descrizione
-1 I suggerimenti per i tasti non vengono visualizzati.
0 Vengono visualizzati i suggerimenti per i tasti.
1 L'utente ha premuto un suggerimento per il tasto visualizzato.

Osservazioni:

CMFCRibbonBar::GetKeyboardNavLevelCurrent

Recupera l'oggetto di spostamento tramite tastiera corrente sulla barra multifunzione.

CObject* GetKeyboardNavLevelCurrent() const;

Valore restituito

Oggetto di spostamento tramite tastiera corrente sulla barra multifunzione; in caso contrario NULL , se nessun oggetto visualizza attualmente i suggerimenti per i tasti.

Osservazioni:

L'oggetto che attualmente visualizza i suggerimenti per i tasti è l'oggetto di spostamento tramite tastiera corrente.

CMFCRibbonBar::GetKeyboardNavLevelParent

Recupera l'oggetto di spostamento tramite tastiera padre sulla barra multifunzione.

CObject* GetKeyboardNavLevelParent() const;

Valore restituito

Oggetto di spostamento tramite tastiera padre sulla barra multifunzione; in caso contrario NULL, .

Osservazioni:

Quando l'utente preme una descrizione dei tasti sulla barra multifunzione, l'oggetto di spostamento tramite tastiera corrente diventa l'oggetto di spostamento tramite tastiera padre.

CMFCRibbonBar::GetMainCategory

Recupera un puntatore alla categoria principale della barra multifunzione.

CMFCRibbonCategory* GetMainCategory() const;

Valore restituito

Puntatore alla categoria principale della barra multifunzione.

Osservazioni:

La categoria principale della barra multifunzione contiene il pannello principale della barra multifunzione.

CMFCRibbonBar::GetQATCommandsLocation

Recupera il rettangolo di visualizzazione per la sezione dei comandi della barra degli strumenti di accesso rapido.

CRect GetQATCommandsLocation() const;

Valore restituito

Rettangolo di visualizzazione per la sezione dei comandi della barra degli strumenti di accesso rapido.

Osservazioni:

La sezione dei comandi del rettangolo di visualizzazione non include il pulsante di personalizzazione.

CMFCRibbonBar::GetQATDroppedDown

Recupera un puntatore all'elemento della barra multifunzione sulla barra degli strumenti di accesso rapido con il relativo menu a comparsa eliminato.

CMFCRibbonBaseElement* GetQATDroppedDown();

Valore restituito

Puntatore all'elemento della barra multifunzione sulla barra degli strumenti di accesso rapido con il relativo menu a comparsa eliminato.

Osservazioni:

CMFCRibbonBar::GetQuickAccessCommands

Recupera un elenco di ID comando per gli elementi della barra multifunzione sulla barra degli strumenti di accesso rapido.

void GetQuickAccessCommands(CList<UINT,UINT>& lstCommands);

Parametri

lstCommands
[out] Elenco di ID comando per gli elementi della barra multifunzione sulla barra degli strumenti di accesso rapido.

Osservazioni:

L'elenco non contiene elementi della barra multifunzione che sono separatori di controllo.

CMFCRibbonBar::GetQuickAccessToolbarLocation

Recupera il rettangolo di visualizzazione per la barra degli strumenti di accesso rapido.

CRect GetQuickAccessToolbarLocation() const;

Valore restituito

Rettangolo di visualizzazione per la barra degli strumenti di accesso rapido.

Osservazioni:

CMFCRibbonBar::GetTabTrancateRatio

Recupera la riduzione delle dimensioni della percentuale nella larghezza di visualizzazione delle schede delle categorie.

int GetTabTrancateRatio() const;

Valore restituito

Riduzione delle dimensioni della percentuale nella larghezza di visualizzazione delle schede delle categorie.

Osservazioni:

Le schede delle categorie vengono ridotte in larghezza quando la larghezza della barra multifunzione non è sufficiente.

CMFCRibbonBar::GetTooltipFixedWidthLargeImage

Recupera le dimensioni elevate della larghezza della descrizione comando per la barra multifunzione.

int GetTooltipFixedWidthLargeImage() const;

Valore restituito

Dimensioni elevate della larghezza della descrizione comando in pixel.

Osservazioni:

Se le dimensioni elevate della larghezza della descrizione comando sono pari a 0, la larghezza varia.

CMFCRibbonBar::GetTooltipFixedWidthRegular

Recupera le dimensioni regolari della larghezza della descrizione comando per la barra multifunzione.

int GetTooltipFixedWidthRegular() const;

Valore restituito

Dimensioni regolari della larghezza della descrizione comando in pixel.

Osservazioni:

Se la dimensione regolare della larghezza della descrizione comando è 0, la larghezza varia.

CMFCRibbonBar::GetVisibleCategoryCount

Recupera il numero di categorie visibili sulla barra multifunzione.

int GetVisibleCategoryCount() const;

Valore restituito

Numero di categorie visibili sulla barra multifunzione.

Osservazioni:

CMFCRibbonBar::HideAllContextCategories

Nasconde tutte le categorie di contesto sulla barra multifunzione.

BOOL HideAllContextCategories();

Valore restituito

TRUE se almeno una categoria di contesto è stata nascosta; in caso contrario, FALSE.

Osservazioni:

Se una categoria di contesto è attiva, la categoria attiva viene reimpostata sulla prima categoria visibile nell'elenco di categorie.

CMFCRibbonBar::HideKeyTips

Nasconde tutti i suggerimenti per i tasti sulla barra multifunzione.

void HideKeyTips();

Osservazioni:

CMFCRibbonBar::HitTest

Recupera un puntatore all'elemento della barra multifunzione specificato dalla posizione del punto.

virtual CMFCRibbonBaseElement* HitTest(
    CPoint point,
    BOOL bCheckActiveCategory= FALSE,
    BOOL bCheckPanelCaption= FALSE);

Parametri

point
[in] Posizione del punto nelle coordinate della barra multifunzione.

bCheckActiveCategory
[in] TRUE per cercare la categoria attiva; FALSE non eseguire ricerche nella categoria attiva.

bCheckPanelCaption
[in] TRUE per testare la didascalia del pannello della barra multifunzione con il punto presente; FALSE non per testare la didascalia del pannello della barra multifunzione con il punto che si trova in esso. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

Puntatore all'elemento della barra multifunzione situato nel punto specificato; in caso contrario NULL , se il punto non si trova in un elemento della barra multifunzione.

Osservazioni:

La didascalia del pannello della barra multifunzione con il punto che si trova in non viene testata a meno che il bCheckActiveCategory parametro non sia TRUE.

CMFCRibbonBar::IsKeyTipEnabled

Indica se la funzionalità dei suggerimenti per i tasti è abilitata.

BOOL IsKeyTipEnabled() const;

Valore restituito

TRUE se la funzionalità dei suggerimenti chiave è abilitata; in caso contrario FALSE, .

CMFCRibbonBar::IsMainRibbonBar

Indica se la barra multifunzione è la barra multifunzione primaria.

virtual BOOL IsMainRibbonBar() const;

Valore restituito

Restituisce sempre TRUE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce TRUEsempre . Eseguire l'override di questo metodo per indicare se la barra multifunzione è la barra multifunzione primaria.

CMFCRibbonBar::IsPrintPreviewEnabled

Indica se la funzionalità Anteprima di stampa è abilitata.

BOOL IsPrintPreviewEnabled() const;

Valore restituito

TRUE se la funzionalità Anteprima di stampa è abilitata; in caso contrario FALSE, .

CMFCRibbonBar::IsQATEmpty

Indica se la barra degli strumenti di accesso rapido contiene pulsanti di comando.

BOOL IsQATEmpty() const;

Valore restituito

TRUE se la barra degli strumenti di accesso rapido contiene pulsanti di comando; in caso contrario FALSE, .

Osservazioni:

CMFCRibbonBar::IsQuickAccessToolbarOnTop

Indica se la barra di accesso rapido si trova sopra o sotto la barra multifunzione.

BOOL IsQuickAccessToolbarOnTop() const;

Valore restituito

TRUE se la barra di accesso rapido si trova sulla barra multifunzione; FALSE se la barra di accesso rapido si trova sotto la barra multifunzione.

CMFCRibbonBar::IsReplaceFrameCaption

Indica se la barra multifunzione sostituisce o è sotto la didascalia della finestra cornice principale.

BOOL IsReplaceFrameCaption() const;

Valore restituito

TRUE se la barra multifunzione sostituisce la didascalia della finestra cornice principale; FALSE se la barra multifunzione è sotto la didascalia della finestra cornice principale.

CMFCRibbonBar::IsShowGroupBorder

Indica se i gruppi di pulsanti presenti sulla barra multifunzione visualizzano un bordo gruppo.

virtual BOOL IsShowGroupBorder(CMFCRibbonButtonsGroup* pGroup) const;

Parametri

pGroup
[in] Questo parametro non viene usato.

Valore restituito

Restituisce sempre FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce FALSEsempre . Eseguire l'override di questo metodo per indicare se i gruppi di pulsanti presenti sulla barra multifunzione visualizzano un bordo gruppo.

CMFCRibbonBar::IsToolTipDescrEnabled

Indica se le descrizioni delle descrizioni comando sono abilitate.

BOOL IsToolTipDescrEnabled() const;

Valore restituito

TRUE se le descrizioni delle descrizioni comando sono abilitate; FALSE se le descrizioni delle descrizioni comando sono disabilitate.

Osservazioni:

Le descrizioni delle descrizioni comando sono testo descrittivo aggiuntivo visualizzato con il testo della descrizione comando.

CMFCRibbonBar::IsToolTipEnabled

Indica se le descrizioni comando sono abilitate o disabilitate per la barra multifunzione.

BOOL IsToolTipEnabled() const;

Valore restituito

TRUE se le descrizioni comando sono abilitate; FALSE se le descrizioni comando sono disabilitate.

CMFCRibbonBar::IsTransparentCaption

Indica se la visualizzazione è impostata per la combinazione di colori Di Windows Aero.

BOOL IsTransparentCaption() const;

Valore restituito

TRUE se la combinazione di colori è Windows Aero; in caso contrario FALSE, .

Osservazioni:

CMFCRibbonBar::OnClickButton

Questo metodo viene mantenuto per garantire la compatibilità con le versioni precedenti con le applicazioni esistenti e non deve essere usato per il nuovo sviluppo.

virtual void OnClickButton(
    CMFCRibbonButton* pButton,
    CPoint point);

Parametri

pButton
[in] Puntatore al pulsante su cui è stato fatto clic.

point
[in] Questo parametro non viene usato.

Osservazioni:

CMFCRibbonBar::OnEditContextMenu

virtual void OnEditContextMenu(
    CMFCRibbonRichEditCtrl* pEdit,
    CPoint point);

Parametri

[in] pEdit
[in] point\

Osservazioni:

CMFCRibbonBar::OnRTLChanged

Chiamato dal framework quando il layout cambia direzione.

virtual void OnRTLChanged(BOOL bIsRTL);

Parametri

bIsRTL
[in] TRUE se il layout è da destra a sinistra; FALSE se il layout è da sinistra a destra.

Osservazioni:

Questo metodo regola il layout di tutti i controlli sulla barra multifunzione per la nuova direzione del layout.

CMFCRibbonBar::OnSetAccData

Questo metodo è interno al framework e non deve essere chiamato dal codice utente.

BOOL OnSetAccData(long lVal);

Parametri

long lVal Indice dell'oggetto accessibile.

Valore restituito

S_OK se ha esito positivo; in caso contrario FALSE o S_FALSE.

Osservazioni:

CMFCRibbonBar::OnShowRibbonContextMenu

virtual BOOL OnShowRibbonContextMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parametri

[in] pWnd
[in] x
[in] y
[in] pHit\

Valore restituito

Osservazioni:

CMFCRibbonBar::OnShowRibbonQATMenu

virtual BOOL OnShowRibbonQATMenu(
    CWnd* pWnd,
    int x,
    int y,
    CMFCRibbonBaseElement* pHit);

Parametri

[in] pWnd
[in] x
[in] y
[in] pHit\

Valore restituito

Osservazioni:

CMFCRibbonBar::OnSysKeyDown

Chiamato dal framework quando l'utente preme il tasto F10 o tiene premuto IL tasto ALT e quindi preme un altro tasto.

BOOL OnSysKeyDown(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parametri

pFrameWnd
[in] Puntatore alla finestra cornice principale padre della barra multifunzione.

wParam
[in] Codice del tasto virtuale premuto.

lParam
[in] Flag di stato della tastiera quando è stato premuto il tasto.

Valore restituito

TRUE se l'evento di sequenza di tasti è stato elaborato; in caso contrario FALSE, .

Osservazioni:

CMFCRibbonBar::OnSysKeyUp

Chiamato dal framework quando l'utente rilascia il tasto F10 , il tasto ALT o un tasto premuto quando il tasto ALT è stato premuto.

BOOL OnSysKeyUp(
    CFrameWnd* pFrameWnd,
    WPARAM wParam,
    LPARAM lParam);

Parametri

pFrameWnd
[in] Puntatore alla finestra cornice principale padre della barra multifunzione.

wParam
[in] Codice della chiave virtuale della chiave rilasciata.

lParam
[in] Questo parametro non viene usato.

Valore restituito

TRUE se l'evento di sequenza di tasti è stato elaborato; in caso contrario FALSE, .

Osservazioni:

CMFCRibbonBar::PopTooltip

Rimuove una descrizione comando dalla visualizzazione.

void PopTooltip();

Osservazioni:

CMFCRibbonBar::PreTranslateMessage

Determina se il messaggio specificato viene elaborato dalla barra multifunzione.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametri

pMsg
[in] Puntatore a un messaggio.

Valore restituito

TRUE se il messaggio è stato elaborato dalla barra multifunzione; in caso contrario FALSE, .

Osservazioni:

CMFCRibbonBar::RecalcLayout

Regola il layout di tutti i controlli sulla barra multifunzione.

virtual void RecalcLayout();

Osservazioni:

Dopo la regolazione del layout, la visualizzazione della barra multifunzione viene aggiornata.

CMFCRibbonBar::RemoveAllCategories

Elimina tutte le categorie della barra multifunzione dalla barra multifunzione.

void RemoveAllCategories();

Osservazioni:

Questo metodo elimina tutte le categorie della barra multifunzione dalla memoria e dall'elenco di categorie.

CMFCRibbonBar::RemoveAllFromTabs

Rimuove tutti gli elementi della barra multifunzione dall'area della scheda.

void RemoveAllFromTabs();

Osservazioni:

Utilizzare questa funzione se si desidera rimuovere tutti gli elementi aggiunti all'area di tabulazione utilizzando il CMFCRibbonBar::AddToTabs metodo .

CMFCRibbonBar::RemoveCategory

Elimina la categoria della barra multifunzione specificata dalla barra multifunzione.

BOOL RemoveCategory(int nIndex);

Parametri

nIndex
[in] Indice in base zero di una categoria nell'elenco delle categorie della barra multifunzione contenute nella barra multifunzione.

Valore restituito

TRUE se la categoria della barra multifunzione specificata è stata eliminata; in caso contrario FALSE, .

Osservazioni:

La categoria della barra multifunzione specificata viene eliminata dalla memoria e dall'elenco di categorie.

CMFCRibbonBar::SetActiveCategory

Imposta la categoria della barra multifunzione specificata come categoria attiva.

BOOL SetActiveCategory(
    CMFCRibbonCategory* pCategory,
    BOOL bForceRestore= FALSE);

Parametri

pCategory
[in] Categoria della barra multifunzione contenuta nella barra multifunzione.

bForceRestore
[in] TRUE per ingrandire la barra multifunzione se è ridotta a icona; FALSE per visualizzare la categoria attiva in una finestra popup se la barra multifunzione è ridotta a icona.

Valore restituito

TRUE se la categoria specificata è stata impostata come categoria attiva; in caso contrario FALSE, .

Osservazioni:

La categoria principale della barra multifunzione non può essere la categoria attiva.

Se la categoria specificata da pCategory non viene visualizzata, non può essere impostata come categoria attiva.

CMFCRibbonBar::SetActiveMDIChild

Associa i pulsanti di sistema sulla barra multifunzione che appartengono a una finestra figlio MDI (Multiple-Document Interface) alla finestra figlio MDI specificata.

void SetActiveMDIChild(CWnd* pWnd);

Parametri

pWnd
[in] Puntatore a una finestra figlio MDI.

Osservazioni:

CMFCRibbonBar::SetApplicationButton

Assegna un pulsante della barra multifunzione dell'applicazione alla barra multifunzione.

void SetApplicationButton(
    CMFCRibbonApplicationButton* pButton,
    CSize sizeButton);

Parametri

pButton
[in] Puntatore al pulsante della barra multifunzione dell'applicazione.

sizeButton
[in] Dimensioni del pulsante della barra multifunzione dell'applicazione.

Osservazioni:

Il pulsante della barra multifunzione dell'applicazione è un pulsante arrotondato grande che si trova nell'angolo superiore sinistro del controllo Barra multifunzione.

Esempio

Nell'esempio seguente viene illustrato come usare il SetApplicationButton metodo nella CMFCRibbonBar classe .

// Init main button:
// CMFCRibbonApplicationButton m_MainButton
m_MainButton.SetImage(IDB_MAIN);
m_MainButton.SetText(_T("\nf"));
m_MainButton.SetToolTipText(strTemp);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetApplicationButton(&m_MainButton, CSize(45, 45));

CMFCRibbonBar::SetElementKeys

Imposta i suggerimenti per tutti gli elementi della barra multifunzione con l'ID comando specificato.

BOOL SetElementKeys(
    UINT uiCmdID,
    LPCTSTR lpszKeys,
    LPCTSTR lpszMenuKeys= NULL);

Parametri

uiCmdID
[in] ID comando di un elemento della barra multifunzione.

lpszKeys
[in] Suggerimento per il tasto.

lpszMenuKeys
[in] Suggerimento per il menu.

Valore restituito

TRUE se vengono impostati i suggerimenti per i tasti di almeno un elemento della barra multifunzione; in caso contrario FALSE, .

Osservazioni:

Il suggerimento del menu facoltativo è destinato agli elementi della barra multifunzione con un pulsante di divisione che apre un menu popup.

CMFCRibbonBar::SetKeyboardNavigationLevel

Imposta il livello di spostamento tramite tastiera quando l'utente preme i suggerimenti per i tasti contenuti sulla barra multifunzione.

void SetKeyboardNavigationLevel(
    CObject* pLevel,
    BOOL bSetFocus = TRUE);

Parametri

pLevel
[in] Puntatore all'oggetto di spostamento tramite tastiera corrente.

bSetFocus
[in] TRUE per impostare lo stato attivo della tastiera sulla barra multifunzione.

Osservazioni:

Lo spostamento tramite tastiera della barra multifunzione viene avviato quando l'utente preme ALT o F10 . L'utente seleziona il livello di spostamento successivo premendo una descrizione comando sulla barra multifunzione. L'utente può tornare al livello di spostamento precedente premendo il tasto di escape.

CMFCRibbonBar::SetMaximizeMode

Regola la barra multifunzione quando la dimensione della finestra di una finestra figlio MDI (Multiple-Document Interface) entra o lascia lo stato ingrandito.

void SetMaximizeMode(
    BOOL bMax,
    CWnd* pWnd = NULL);

Parametri

bMax
[in] TRUE per visualizzare i pulsanti di sistema per una finestra figlio MDI sulla barra multifunzione; FALSE per rimuovere i pulsanti di sistema per una finestra figlio MDI dalla barra multifunzione.

pWnd
[in] Puntatore alla finestra cornice principale per la barra multifunzione.

Osservazioni:

La barra multifunzione visualizza i pulsanti di sistema per una finestra figlio MDI nella riga della scheda quando una finestra figlio MDI è ingrandita.

CMFCRibbonBar::SetQuickAccessCommands

Aggiunge uno o più elementi della barra multifunzione alla barra di accesso rapido.

void SetQuickAccessCommands(
    const CList<UINT,UINT>& lstCommands,
    BOOL bRecalcLayout=TRUE);

Parametri

lstCommands
[in] Elenco di comandi da inserire sulla barra di accesso rapido.

bRecalcLayout
[in] TRUE se si desidera ridisegnare la barra multifunzione dopo aver aggiunto gli elementi della barra multifunzione; FALSE altrimenti.

Esempio

Nell'esempio seguente viene illustrato come usare il SetQuickAccessCommands metodo nella CMFCRibbonBar classe .

// Add quick access commands to the toolbar
CList<UINT, UINT> lstQATCmds;

lstQATCmds.AddTail(ID_FILE_NEW);
lstQATCmds.AddTail(ID_FILE_OPEN);
lstQATCmds.AddTail(ID_FILE_SAVE);
lstQATCmds.AddTail(ID_FILE_PRINT_DIRECT);

// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessCommands(lstQATCmds);

CMFCRibbonBar::SetQuickAccessDefaultState

Imposta la barra degli strumenti di accesso rapido sullo stato predefinito.

void SetQuickAccessDefaultState(const CMFCRibbonQuickAccessToolBarDefaultState& state);

Parametri

state
[in] Stato predefinito della barra di accesso rapido.

Osservazioni:

Lo stato della barra degli strumenti di accesso rapido include un elenco di comandi e la relativa visibilità.

Esempio

Nell'esempio seguente viene illustrato come usare il SetQuickAccessDefaultState metodo nella CMFCRibbonBar classe .

CMFCRibbonQuickAccessToolBarDefaultState *qaToolBarState =
    new CMFCRibbonQuickAccessToolBarDefaultState();
qaToolBarState->AddCommand(ID_FILE_NEW, true);
qaToolBarState->AddCommand(ID_FILE_OPEN, true);
// CMFCRibbonBar m_wndRibbonBar
m_wndRibbonBar.SetQuickAccessDefaultState(*qaToolBarState);

CMFCRibbonBar::SetQuickAccessToolbarOnTop

Posiziona la barra di accesso rapido sopra o sotto la barra multifunzione.

void SetQuickAccessToolbarOnTop(BOOL bOnTop);

Parametri

bOnTop
[in] TRUE per posizionare la barra di accesso rapido sopra la barra multifunzione; FALSE per posizionare la barra di accesso rapido sotto la barra multifunzione.

CMFCRibbonBar::SetTooltipFixedWidth

Imposta le dimensioni regolari e grandi della larghezza fissa della descrizione comando per la barra multifunzione.

void SetTooltipFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parametri

nWidthRegular
[in] Larghezza, in pixel, di una descrizione comando a dimensione fissa normale.

nWidthLargeImage
[in] Larghezza, in pixel, di una descrizione comando di grandi dimensioni a dimensione fissa.

Osservazioni:

Se si imposta un parametro su 0, la larghezza corrispondente varia.

CMFCRibbonBar::ShowCategory

Mostra o nasconde la categoria specificata della barra multifunzione.

void ShowCategory(
    int nIndex,
    BOOL bShow=TRUE);

Parametri

nIndex
[in] Indice della categoria della barra multifunzione.

bShow
[in] Se TRUE, visualizzare la categoria della barra multifunzione; in caso contrario, nascondere la categoria della barra multifunzione.

CMFCRibbonBar::ShowContextCategories

Mostra o nasconde le categorie contesto con l'ID specificato.

void ShowContextCategories(
    UINT uiContextID,
    BOOL bShow=TRUE);

Parametri

uiContextID
[in] ID categoria contesto.

bShow
[in] Se TRUE, visualizzare le categorie con l'ID specificato; in caso contrario, nascondere le categorie con l'ID specificato.

CMFCRibbonBar::ShowKeyTips

Mostra i suggerimenti per ogni elemento della barra multifunzione sulla barra multifunzione.

void ShowKeyTips();

Osservazioni:

CMFCRibbonBar::ToggleMimimizeState

Consente di visualizzare la barra multifunzione ridotta a icona e ingrandita e viceversa.

void ToggleMimimizeState();

Osservazioni:

L'errore di ortografia nel nome del metodo è un problema noto.

In modalità ridotto a icona il controllo della barra multifunzione è nascosto e solo le schede sono visualizzate. Quando l'utente fa clic sulla scheda, il controllo della barra multifunzione viene visualizzato come finestra popup. La finestra si chiude quando l'utente fa clic altrove o esegue un comando.

CMFCRibbonBar::TranslateChar

Determina se il codice carattere della sequenza di tasti specificato viene elaborato dalla barra multifunzione.

virtual BOOL TranslateChar(UINT nChar);

Parametri

nChar
[in] Codice carattere della sequenza di tasti utente.

Valore restituito

TRUE se il codice carattere è stato elaborato dalla barra multifunzione; in caso contrario FALSE, .

Osservazioni:

La funzionalità dei suggerimenti per i tasti consente agli utenti di spostarsi nella barra multifunzione usando la tastiera.

CMFCRibbonBar::GetFocused

Restituisce un elemento con stato attivo.

virtual CMFCRibbonBaseElement* GetFocused();

Valore restituito

Puntatore a un elemento con stato attivo o NULLa .

Osservazioni:

CMFCRibbonBar::IsWindows7Look

Indica se la barra multifunzione ha un aspetto di Windows 7 (piccolo pulsante di applicazione rettangolare).

BOOL IsWindows7Look() const;

Valore restituito

TRUE se la barra multifunzione ha un aspetto di Windows 7; in caso contrario FALSE, .

Osservazioni:

CMFCRibbonBar::LoadFromResource

Con overload. Carica una barra multifunzione dalle risorse dell'applicazione.

virtual BOOL LoadFromResource(
    UINT uiXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

virtual BOOL LoadFromResource(
    LPCTSTR lpszXMLResID,
    LPCTSTR lpszResType = RT_RIBBON,
    HINSTANCE hInstance = NULL);

Parametri

uiXMLResID
Specifica l'ID risorsa della stringa XML con informazioni sulla barra multifunzione.

lpszResType
Specifica il tipo di risorsa che si trova in uiXMLResID.

hInstance
Handle per il modulo il cui file eseguibile contiene la risorsa. Se hInstance è NULL, il sistema carica la risorsa dal modulo usato per creare il processo corrente.

lpszXMLResID
Specifica l'ID risorsa (in formato stringa) con informazioni sulla barra multifunzione.

Valore restituito

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

Osservazioni:

CMFCRibbonBar::SaveToXMLBuffer

Salva la barra multifunzione in un buffer.

UINT SaveToXMLBuffer(LPBYTE* ppBuffer) const;

Parametri

ppBuffer
Quando questa funzione viene restituita, ppBuffer punta a un buffer allocato da questo metodo e contiene informazioni sulla barra multifunzione in formato XML.

Valore restituito

TRUE se l'esito è positivo; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonBar::SaveToXMLFile

Salva la barra multifunzione in un file XML.

BOOL SaveToXMLFile(LPCTSTR lpszFilePath) const;

Parametri

lpszFilePath
Specifica il file di output.

Valore restituito

TRUE se l'esito è positivo; in caso contrario, FALSE.

Osservazioni:

CMFCRibbonBar::SetWindows7Look

Abilita o disabilita un aspetto di Windows 7 (piccolo pulsante di applicazione rettangolare) per la barra multifunzione.

void SetWindows7Look(
    BOOL bWindows7Look,
    BOOL bRecalc = TRUE);

Parametri

bWindows7Look
TRUE imposta un aspetto di Windows 7; FALSE altrimenti.

bRecalc
TRUE ricalcola il layout della barra multifunzione; FALSE altrimenti.

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi
CPane Classe
CMFCRibbonCategory Classe
CMFCRibbonPanel Classe
CMFCRibbonBaseElement Classe
Procedura dettagliata: Aggiornamento dell'applicazione MFC Scribble