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à
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 categoria di contesto didascalia.
uiContextID
[in] ID contesto.
clrContext
[in] Colore della categoria di contesto didascalia.
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_NoneAFX_CategoryColor_RedAFX_CategoryColor_OrangeAFX_CategoryColor_YellowAFX_CategoryColor_GreenAFX_CategoryColor_BlueAFX_CategoryColor_IndigoAFX_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 affinché la barra multifunzione sostituisca 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 didascalia per la barra multifunzione.
int GetCaptionHeight() const;
Valore restituito
Altezza, in pixel, dell'area 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 categoria di contesto didascalia specificato 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 categoria di contesto didascalia.
Valore restituito
TRUEse il metodo ha avuto esito positivo; in caso contrario, FALSE se uiContextID è stato zero o la categoria di contesto didascalia 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:
| Contrassegno | 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 il didascalia del pannello della barra multifunzione con il punto che si trova in esso; FALSE non 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:
Il didascalia del pannello della barra multifunzione con il punto che si trova in non viene testato 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 si trova nella didascalia della finestra cornice principale.
BOOL IsReplaceFrameCaption() const;
Valore restituito
TRUEse la barra multifunzione sostituisce il didascalia della finestra cornice principale; FALSE se la barra multifunzione si trova sotto il 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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per