Classe `CMFCRibbonBar`

Articolo
10/12/2023

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à

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

Condividi tramite

Classe CMFCRibbonBar

Sintassi

Membri

Costruttori pubblici

Metodi pubblici

Osservazioni:

Gerarchia di ereditarietà

Requisiti

CMFCRibbonBar::ActivateContextCategory

Parametri

Valore restituito

CMFCRibbonBar::AddCategory

Parametri

Valore restituito

Osservazioni:

Esempio

CMFCRibbonBar::AddContextCategory

Parametri

Valore restituito

Osservazioni:

CMFCRibbonBar::AddMainCategory

Parametri

Valore restituito

Osservazioni:

Esempio

CMFCRibbonBar::AddPrintPreviewCategory

Valore restituito

Osservazioni:

CMFCRibbonBar::AddQATOnlyCategory

Parametri

Valore restituito

Osservazioni:

CMFCRibbonBar::AddToTabs

Parametri

Osservazioni:

CMFCRibbonBar::CMFCRibbonBar

Parametri

Osservazioni:

CMFCRibbonBar::Create

Parametri

Valore restituito

Osservazioni:

Esempio

CMFCRibbonBar::CreateEx

Parametri

Valore restituito

Osservazioni:

CMFCRibbonBar::DeactivateKeyboardFocus

Parametri

Osservazioni:

CMFCRibbonBar::DrawMenuImage

Parametri

Valore restituito

Osservazioni:

CMFCRibbonBar::DWMCompositionChanged

Osservazioni:

CMFCRibbonBar::EnableKeyTips

Parametri

Osservazioni:

CMFCRibbonBar::EnablePrintPreview

Parametri

Osservazioni:

CMFCRibbonBar::EnableToolTips

Parametri

Osservazioni:

CMFCRibbonBar::FindByData

Parametri

Valore restituito

Osservazioni:

CMFCRibbonBar::FindByID

Parametri

Valore restituito

Osservazioni:

CMFCRibbonBar::FindCategoryIndexByData

Parametri

Valore restituito

CMFCRibbonBar::ForceRecalcLayout

Osservazioni:

CMFCRibbonBar::GetActiveCategory

Classe `CMFCRibbonBar`

`CMFCRibbonBar::ActivateContextCategory`

`CMFCRibbonBar::AddCategory`

`CMFCRibbonBar::AddContextCategory`

`CMFCRibbonBar::AddMainCategory`

`CMFCRibbonBar::AddPrintPreviewCategory`

`CMFCRibbonBar::AddQATOnlyCategory`

`CMFCRibbonBar::AddToTabs`

`CMFCRibbonBar::CMFCRibbonBar`

`CMFCRibbonBar::Create`

`CMFCRibbonBar::CreateEx`

`CMFCRibbonBar::DeactivateKeyboardFocus`

`CMFCRibbonBar::DrawMenuImage`

`CMFCRibbonBar::DWMCompositionChanged`

`CMFCRibbonBar::EnableKeyTips`

`CMFCRibbonBar::EnablePrintPreview`

`CMFCRibbonBar::EnableToolTips`

`CMFCRibbonBar::FindByData`

`CMFCRibbonBar::FindByID`

`CMFCRibbonBar::FindCategoryIndexByData`

`CMFCRibbonBar::ForceRecalcLayout`

`CMFCRibbonBar::GetActiveCategory`

`CMFCRibbonBar::GetApplicationButton`

`CMFCRibbonBar::GetCaptionHeight`

`CMFCRibbonBar::GetCategory`

`CMFCRibbonBar::GetCategoryCount`

`CMFCRibbonBar::GetCategoryHeight`

`CMFCRibbonBar::GetCategoryIndex`

`CMFCRibbonBar::GetContextName`

`CMFCRibbonBar::GetDroppedDown`

`CMFCRibbonBar::GetElementsByID`

`CMFCRibbonBar::GetHideFlags`

`CMFCRibbonBar::GetItemIDsList`

`CMFCRibbonBar::GetKeyboardNavigationLevel`

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

`CMFCRibbonBar::GetKeyboardNavLevelParent`

`CMFCRibbonBar::GetMainCategory`

`CMFCRibbonBar::GetQATCommandsLocation`

`CMFCRibbonBar::GetQATDroppedDown`

`CMFCRibbonBar::GetQuickAccessCommands`

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

`CMFCRibbonBar::GetTabTrancateRatio`

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

`CMFCRibbonBar::GetVisibleCategoryCount`