`CMFCRibbonBar`-klass

Artikel
03/17/2025

Klassen CMFCRibbonBar implementerar ett bandfält som liknar det som används i Office 2007.

Mer information finns i källkoden som finns i mappen mfc i Visual Studio-installationen. Till exempel %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Syntax

class CMFCRibbonBar : public CPane

Medlemmar

Offentliga konstruktorer

Namn	Beskrivning
`CMFCRibbonBar::CMFCRibbonBar`	Standardkonstruktor.

Offentliga metoder

Namn	Beskrivning
`CMFCRibbonBar::ActivateContextCategory`	Aktiverar en kontextkategori som redan är synlig.
`CMFCRibbonBar::AddCategory`	Lägger till en ny menyflikskategori i menyfliksområdet.
`CMFCRibbonBar::AddContextCategory`	Lägger till en kontextkategori.
`CMFCRibbonBar::AddMainCategory`	Lägger till en ny huvudkategori i menyfliksområdet.
`CMFCRibbonBar::AddPrintPreviewCategory`
`CMFCRibbonBar::AddQATOnlyCategory`
`CMFCRibbonBar::AddToTabs`	Lägg till ett menyflikselement till höger i ett bandfält.
`CMFCRibbonBar::CreateEx`	Skapar ett kontrollfält och kopplar det till `CPane`-objektet. (Åsidosätter `CPane::CreateEx`.)
`CMFCRibbonBar::Create`	Skapar en bandlistkontroll och kopplar den till ett bandfält.
`CMFCRibbonBar::DeactivateKeyboardFocus`
`CMFCRibbonBar::DrawMenuImage`
`CMFCRibbonBar::DWMCompositionChanged`
`CMFCRibbonBar::EnableKeyTips`	Aktivera eller inaktivera nyckeltips för menyfliksområdet.
`CMFCRibbonBar::EnablePrintPreview`	Aktivera fliken Förhandsgranskning.
`CMFCRibbonBar::EnableToolTips`	Aktiverar eller inaktiverar knappbeskrivningar och beskrivningar av knappbeskrivningar i menyfliksområdet.
`CMFCRibbonBar::FindByData`	Hitta ett menyflikselement med hjälp av data som en användare anger.
`CMFCRibbonBar::FindByID`	Hittar ett bandelement som har det angivna kommando-ID:t.
`CMFCRibbonBar::FindCategoryIndexByData`	Hittar indexet för den menyfliksområdeskategori som innehåller användardefinierade data.
`CMFCRibbonBar::ForceRecalcLayout`
`CMFCRibbonBar::GetActiveCategory`	Hämtar en pekare till en aktiv kategori.
`CMFCRibbonBar::GetCaptionHeight`	Returnerar bildtextens höjd. (Åsidosätter `CBasePane::GetCaptionHeight`.)
`CMFCRibbonBar::GetCategory`	Hämtar pekaren till en kategori som finns i ett angivet index.
`CMFCRibbonBar::GetCategoryCount`	Hämtar antalet menyflikskategorier i menyfliksområdet.
`CMFCRibbonBar::GetCategoryHeight`
`CMFCRibbonBar::GetCategoryIndex`	Returnerar indexet för en menyflikskategori.
`CMFCRibbonBar::GetContextName`	Hämtar namnet på den kontextkategorirubrik som du anger med hjälp av ett ID.
`CMFCRibbonBar::GetDroppedDown`
`CMFCRibbonBar::GetElementsByID`	Hämtar en matris som innehåller pekarna till alla bandelement som har det angivna ID:t.
`CMFCRibbonBar::GetApplicationButton`	Hämtar en pekare till en menyfliksknapp.
`CMFCRibbonBar::GetFocused`	Returnerar ett fokuserat element.
`CMFCRibbonBar::GetHideFlags`
`CMFCRibbonBar::GetItemIDsList`
`CMFCRibbonBar::GetKeyboardNavigationLevel`
`CMFCRibbonBar::GetKeyboardNavLevelCurrent`
`CMFCRibbonBar::GetKeyboardNavLevelParent`
`CMFCRibbonBar::GetMainCategory`	Returnerar en pekare till den menyfliksområdeskategori som för närvarande är markerad.
`CMFCRibbonBar::GetQATCommandsLocation`
`CMFCRibbonBar::GetQATDroppedDown`
`CMFCRibbonBar::GetQuickAccessCommands`	Fyller i en lista som innehåller kommando-ID:t för alla element som visas i verktygsfältet Snabbåtkomst.
`CMFCRibbonBar::GetQuickAccessToolbarLocation`
`CMFCRibbonBar::GetTabTrancateRatio`
`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`
`CMFCRibbonBar::GetTooltipFixedWidthRegular`
`CMFCRibbonBar::GetVisibleCategoryCount`
`CMFCRibbonBar::HideAllContextCategories`	Döljer alla kategorier som är aktiva och synliga.
`CMFCRibbonBar::HideKeyTips`
`CMFCRibbonBar::HitTest`	Hittar en pekare till menyflikselementet som finns på den angivna punkten i menyfliksområdets klientkoordinater.
`CMFCRibbonBar::IsKeyTipEnabled`	Avgör om nyckelbeskrivningar är aktiverade.
`CMFCRibbonBar::IsMainRibbonBar`
`CMFCRibbonBar::IsPrintPreviewEnabled`	Avgör om fliken Förhandsgranskning är aktiverad.
`CMFCRibbonBar::IsQATEmpty`
`CMFCRibbonBar::IsQuickAccessToolbarOnTop`	Anger om verktygsfältet Snabbåtkomst finns ovanför menyfliksområdet.
`CMFCRibbonBar::IsReplaceFrameCaption`	Avgör om menyfliksområdet ersätter huvudramens bildtext eller läggs till under ramrubriken.
`CMFCRibbonBar::IsShowGroupBorder`
`CMFCRibbonBar::IsToolTipDescrEnabled`	Avgör om knappbeskrivningarna är aktiverade.
`CMFCRibbonBar::IsToolTipEnabled`	Avgör om knappbeskrivningarna för menyfliksområdet är aktiverade.
`CMFCRibbonBar::IsTransparentCaption`
`CMFCRibbonBar::IsWindows7Look`	Anger om menyfliksområdet har windows 7-stil (liten rektangulär programknapp).
`CMFCRibbonBar::LoadFromResource`	Överbelastad. Läser in ett bandfält från programresurser.
`CMFCRibbonBar::OnClickButton`
`CMFCRibbonBar::OnEditContextMenu`
`CMFCRibbonBar::OnRTLChanged`	(Åsidosätter `CPane::OnRTLChanged`.)
`CMFCRibbonBar::OnSetAccData`	(Åsidosätter `CBasePane::OnSetAccData`.)
`CMFCRibbonBar::OnShowRibbonContextMenu`
`CMFCRibbonBar::OnShowRibbonQATMenu`
`CMFCRibbonBar::OnSysKeyDown`
`CMFCRibbonBar::OnSysKeyUp`
`CMFCRibbonBar::PopTooltip`
`CMFCRibbonBar::PreTranslateMessage`	(Åsidosätter `CBasePane::PreTranslateMessage`.)
`CMFCRibbonBar::RecalcLayout`	(Åsidosätter `CPane::RecalcLayout`.)
`CMFCRibbonBar::RemoveAllCategories`	Tar bort alla menyflikskategorier från menyfliksområdet.
`CMFCRibbonBar::RemoveAllFromTabs`	Tar bort alla menyflikselement från flikområdet.
`CMFCRibbonBar::RemoveCategory`	Tar bort den menyfliksområdeskategori som finns i det angivna indexet.
`CMFCRibbonBar::SaveToXMLBuffer`	Sparar menyfliksområdet i en buffert.
`CMFCRibbonBar::SaveToXMLFile`	Sparar menyfliksområdet i XML-filen.
`CMFCRibbonBar::SetActiveCategory`	Anger en angiven menyfliksområdeskategori till aktiv.
`CMFCRibbonBar::SetActiveMDIChild`
`CMFCRibbonBar::SetElementKeys`	Anger de angivna nyckelbeskrivningarna för alla menyflikselement som har det angivna kommando-ID:t.
`CMFCRibbonBar::SetApplicationButton`	Tilldelar en menyfliksknapp för program till menyfliksområdet.
`CMFCRibbonBar::SetKeyboardNavigationLevel`
`CMFCRibbonBar::SetMaximizeMode`
`CMFCRibbonBar::SetQuickAccessCommands`	Lägger till ett eller flera menyflikselement i verktygsfältet Snabbåtkomst.
`CMFCRibbonBar::SetQuickAccessDefaultState`	Anger standardtillståndet för verktygsfältet Snabbåtkomst.
`CMFCRibbonBar::SetQuickAccessToolbarOnTop`	Placerar verktygsfältet snabbåtkomst (QAT) ovanför eller under menyfliksområdet.
`CMFCRibbonBar::SetTooltipFixedWidth`
`CMFCRibbonBar::SetWindows7Look`	Aktivera/inaktivera menyfliksområdet i Windows 7-stil (liten rektangulär programknapp)
`CMFCRibbonBar::ShowCategory`	Visar eller döljer den angivna menyfliksområdets kategori.
`CMFCRibbonBar::ShowContextCategories`	Visar eller döljer de kontextkategorier som har det angivna ID:t.
`CMFCRibbonBar::ShowKeyTips`
`CMFCRibbonBar::ToggleMimimizeState`	Växlar menyfliksområdet mellan minimerade och maximerade tillstånd.
`CMFCRibbonBar::TranslateChar`

Anmärkningar

Microsoft introducerade Menyfliksområdet Office Fluent när det släppte Microsoft Office 2007 samtidigt. Det här menyfliksområdet är inte bara en ny kontroll. Det representerar ett nytt användargränssnittsparadigm. Menyfliksområdet är ett fönster som innehåller en uppsättning flikar som kallas kategorier. Varje kategori är logiskt uppdelad i bandpaneler och varje panel kan innehålla olika kontroller och kommandoknappar.

De element som visas i menyfliksområdet expanderas och kontrakt för att utnyttja tillgängligt utrymme på bästa sätt. Om en menyflikspanel till exempel inte har tillräckligt med utrymme för att visa dess element blir den en menyknapp som visar underwebbplatser på en popup-meny. Bandfältet fungerar som ett statiskt (icke-flytande) kontrollfält och kan dockas överst i en ram.

Du kan använda klassen CMFCRibbonStatusBar för att implementera ett statusfält som liknar det som används i Office 2007. En menyflikskategori innehåller (och visar) en grupp med menyflikspaneler. Varje panel i menyfliksområdet innehåller ett eller flera bandelement som härleds från CMFCRibbonBaseElement.

Information om hur du lägger till ett bandfält i ditt befintliga MFC-program finns i Genomgång: Uppdatera MFC Scribble Application.

Arvshierarki

Krav

rubrik:afxribbonbar.h

`CMFCRibbonBar::ActivateContextCategory`

Aktiverar en kontextkategori som redan är synlig.

BOOL ActivateContextCategory(UINT uiContextID);

Parametrar

uiContextID
[i] Kontextkategori-ID.

Returvärde

TRUE om en kontextkategori med uiContextID hittas och aktiveras. annars FALSE.

`CMFCRibbonBar::AddCategory`

Skapar och initierar en ny menyflikskategori för menyfliksområdet.

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

Parametrar

lpszName
[i] Namnet på menyfliksområdets kategori.

uiSmallImagesResID
[i] Resurs-ID för den lilla bildlistan för menyfliksområdets kategori.

uiLargeImagesResID
[i] Resurs-ID för den stora bildlistan för menyfliksområdets kategori.

sizeSmallImage
[i] Anger storleken på små bilder för menyfliksområdets kategori.

sizeLargeImage
[i] Anger storleken på stora bilder för menyfliksområdets kategori.

nInsertAt
[i] Nollbaserat index för kategoriplatsen.

pRTI
[i] Pekare till en CMFCRibbonCategory klass körningsklass för att dynamiskt skapa en menyflikskategori vid körning.

Returvärde

En pekare till den nya menyfliksområdets kategori om metoden lyckades. annars NULL.

Anmärkningar

Om parametern pRTI inte är NULLskapas den nya menyfliksområdet dynamiskt med hjälp av körningsklassen.

Exempel

I följande exempel visas hur du använder metoden AddCategory i klassen CMFCRibbonBar.

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

`CMFCRibbonBar::AddContextCategory`

Skapar och initierar en ny kontextkategori för menyfliksområdet.

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

Parametrar

lpszName
[i] Namnet på kategorin.

lpszContextName
[i] Namnet på beskrivningen av kontextkategorin.

uiContextID
[i] Kontext-ID.

clrContext
[i] Färg på rubrik för kontextkategori.

uiSmallImagesResID
[i] Resurs-ID för den lilla bilden av en kontextkategori.

uiLargeImagesResID
[i] Resurs-ID för den stora bilden av en kontextkategori.

sizeSmallImage
[i] Storleken på en liten bild.

sizeLargeImage
[i] Storleken på en stor bild.

pRTI
[i] Pekare till en körningsklass.

Returvärde

En pekare till den nyligen skapade kategorin eller NULL om den CreateObject metoden för pRTI inte kan skapa den angivna kategorin.

Anmärkningar

Använd den här funktionen för att lägga till en kontextkategori. Kontextkategorier är en särskild typ av kategori som kan visas eller döljas vid körning, beroende på den aktuella programkontexten. När användaren till exempel väljer ett objekt kan du visa särskilda flikar med kontextkategorier som du använder för att ändra det specifika markerade objektet.

Färgen på en kontextkategori kan vara något av följande värden:

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`

Skapar en ny huvudbandskategori för menyfliksområdet.

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

Parametrar

lpszName
[i] Namnet på huvudkategorin i menyfliksområdet.

uiSmallImagesResID
[i] Resurs-ID för små bilder.

uiLargeImagesResID
[i] Resurs-ID för stora bilder.

sizeSmallImage
[i] Storleken på små bilder.

sizeLargeImage
[i] Storleken på stora bilder.

Returvärde

Pekare till den nya huvudkategorin i menyfliksområdet om metoden lyckades. annars NULL.

Anmärkningar

Om det redan finns en huvudkategori i menyfliksområdet tas den bort.

Exempel

I följande exempel visas hur du använder metoden AddMainCategory i klassen CMFCRibbonBar.

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

Skapar en förhandsgranskningskategori i menyfliksområdet.

CMFCRibbonCategory* AddPrintPreviewCategory();

Returvärde

En pekare till den nya menyfliksområdets kategori om metoden lyckades. annars NULL.

Anmärkningar

Den här metoden skapar en menyflikskategori och de kontroller som behövs för att tillhandahålla en förhandsgranskning.

`CMFCRibbonBar::AddQATOnlyCategory`

Skapar en menyflikskategori för snabbåtkomst i verktygsfältet.

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

Parametrar

lpszName
[i] Namnet på kategorin.

uiSmallImagesResID
[i] Resurs-ID för bildlistan för kategorin.

sizeSmallImage
[i] Storleken på bilder för menyflikselement i kategorin.

Returvärde

En pekare till den nya kategorin om metoden lyckades. annars NULL.

Anmärkningar

Menyfliksområdet snabbåtkomst i verktygsfältet används endast i dialogrutan anpassning av verktygsfältet för snabbåtkomst.

`CMFCRibbonBar::AddToTabs`

Lägger till det angivna menyflikselementet på tabbarraden i menyfliksområdet.

void AddToTabs(CMFCRibbonBaseElement* pElement);

Parametrar

pElement
[i] Pekare till ett menyflikselement.

Anmärkningar

Menyflikselementet placeras före eventuella systemknappar.

`CMFCRibbonBar::CMFCRibbonBar`

Konstruerar och initierar ett CMFCRibbonBar objekt.

CMFCRibbonBar(BOOL bReplaceFrameCaption = TRUE);

Parametrar

bReplaceFrameCaption
[i] TRUE för menyfliksområdet för att ersätta undertexten i huvudramfönstret. FALSE för att hitta menyfliksområdet under rubriken i huvudramfönstret.

Anmärkningar

`CMFCRibbonBar::Create`

Skapar ett fönster för menyfliksområdet.

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

Parametrar

pParentWnd
[i] Pekare till det överordnade fönstret för menyfliksområdet.

dwStyle
[i] En logisk kombination av formatmallar för det nya fönstret.

nID
[i] ID för det nya fönstret.

Returvärde

TRUE om fönstret skapades. annars FALSE.

Anmärkningar

Exempel

I följande exempel visas hur du använder Create-metoden för klassen CMFCRibbonBar.

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

`CMFCRibbonBar::CreateEx`

Skapar ett fönster för menyfliksområdet.

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

Parametrar

pParentWnd
[i] Pekare till det överordnade fönstret för menyfliksområdet.

dwCtrlStyle
[i] Den här parametern används inte.

dwStyle
[i] En logisk kombination av formatmallar för det nya fönstret.

nID
[i] ID för det nya fönstret.

Returvärde

TRUE om fönstret skapades. annars FALSE.

Anmärkningar

`CMFCRibbonBar::DeactivateKeyboardFocus`

Stänger alla knappbeskrivningskontroller i menyfliksområdet.

void DeactivateKeyboardFocus(BOOL bSetFocus = TRUE);

Parametrar

bSetFocus
[i] TRUE för att ställa in fokus på det överordnade fönstret i menyfliksområdet.

Anmärkningar

`CMFCRibbonBar::DrawMenuImage`

Ritar bilden för en menyknapp.

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

Parametrar

pDC
[i] Pekare till en enhetskontext för menyknappen.

pMenuItem
[i] Pekare till en menyknapp i verktygsfältet.

rectImage
[i] Visa rektangel för en menyknapp.

Returvärde

TRUE om bilden ritades; annars FALSE.

Anmärkningar

`CMFCRibbonBar::DWMCompositionChanged`

Justerar visningen av menyfliksområdet när dwm-kompositionen (Desktop Window Manager) är aktiverad eller inaktiverad.

virtual void DWMCompositionChanged();

Anmärkningar

`CMFCRibbonBar::EnableKeyTips`

Aktiverar eller inaktiverar knappbeskrivningsfunktionen för menyfliksområdet.

void EnableKeyTips(BOOL bEnable = TRUE);

Parametrar

bEnable
[i] TRUE för att aktivera funktionen för knappbeskrivningar. FALSE för att inaktivera funktionen för knappbeskrivningar.

Anmärkningar

När du aktiverar den här funktionen visas viktiga tips när användaren trycker på ALT- eller F10 nycklar. När användaren trycker på ALT--tangenten visas viktiga tips med en fördröjning på 200 millisekunder. Med den här fördröjningen kan genvägar köras så att den pressade ALT--tangenten inte stör andra kombinationer som innehåller ALT--tangenten.

`CMFCRibbonBar::EnablePrintPreview`

Aktiverar eller inaktiverar funktionen Förhandsgranskning.

void EnablePrintPreview(BOOL bEnable = TRUE);

Parametrar

bEnable
[i] TRUE för att aktivera funktionen förhandsgranskning. FALSE om du vill inaktivera funktionen förhandsgranskning.

Anmärkningar

Om bEnable är FALSE och det finns en förhandsgranskningskategori tas den bort.

Som standard är funktionen Förhandsgranskning aktiverad.

`CMFCRibbonBar::EnableToolTips`

Aktiverar eller inaktiverar knappbeskrivningar och valfria beskrivningar av knappbeskrivningar i menyfliksområdet.

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

Parametrar

bEnable
[i] TRUE för att aktivera knappbeskrivningar i menyfliksområdet. FALSE för att inaktivera knappbeskrivningar i menyfliksområdet.

bEnableDescr
[i] TRUE för att aktivera beskrivningar av knappbeskrivningar i knappbeskrivningen. FALSE för att inaktivera beskrivningar av knappbeskrivningar i knappbeskrivningen.

Anmärkningar

Parametern bEnable avgör om knappbeskrivningar visas när musen hovrar över ett menyflikselement. Parametern bEnableDescr avgör om ytterligare beskrivande text visas med knappbeskrivningstexten.

`CMFCRibbonBar::FindByData`

Hämtar en pekare till ett menyfliksområde om det har angivna data och synlighet.

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

Parametrar

dwData
[i] Data som är associerade med ett bandelement.

bVisibleOnly
[i] TRUE endast söka efter synliga menyflikselement. FALSE för att söka i alla element i menyfliksområdet.

Returvärde

En pekare till ett bandelement om det har angivna data och synlighet. annars NULL.

Anmärkningar

Ett menyflikselement är en kontroll som du kan lägga till i menyfliksområdet, till exempel en menyfliksknapp, en menyflikskategori eller ett skjutreglage för menyfliksområdet.

`CMFCRibbonBar::FindByID`

Hämtar en pekare till menyfliksområdet som har det angivna kommando-ID:t och sökvärdena.

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

Parametrar

uiCmdID
[i] Kommando-ID för ett menyflikselement.

bVisibleOnly
[i] TRUE endast söka efter synliga menyflikselement. FALSE för att söka i alla element i menyfliksområdet.

bExcludeQAT
[i] TRUE att undanta verktygsfältselement för snabbåtkomst från sökningen. annars FALSE.

Returvärde

En pekare till ett menyflikselement om det har det angivna kommando-ID:t och sökvärdena. annars NULL.

Anmärkningar

Ett bandelement är valfri menyflikskontroll som kan läggas till i menyfliksområdet, till exempel en menyfliksknapp, en menyflikskategori eller ett skjutreglage för menyfliksområdet.

I allmänhet kan det finnas fler än ett menyflikselement som har samma kommando-ID. Om du vill hämta pekare till alla menyflikselement som använder ett angivet kommando-ID använder du metoden CMFCRibbonBar::GetElementsByID.

`CMFCRibbonBar::FindCategoryIndexByData`

Hämtar indexet för den menyfliksområdeskategori som innehåller angivna data.

int FindCategoryIndexByData(DWORD dwData) const;

Parametrar

dwData
[i] De data som är associerade med en menyflikskategori.

Returvärde

Det nollbaserade indexet för en menyflikskategori om metoden lyckades. annars -1.

`CMFCRibbonBar::ForceRecalcLayout`

Justerar layouten för alla objekt i menyfliksområdet och det överordnade fönstret och ritar om hela fönstret.

void ForceRecalcLayout();

Anmärkningar

`CMFCRibbonBar::GetActiveCategory`

Hämtar en pekare till den aktiva menyfliksområdets kategori.

CMFCRibbonCategory* GetActiveCategory() const;

Returvärde

En pekare till den aktiva menyfliksområdets kategori. eller NULL om ingen kategori är aktiv.

Anmärkningar

En kategori är aktiv om den har fokus. Som standard är den aktiva kategorin den första kategorin till vänster i menyfliksområdet.

Huvudkategorin visas när användaren trycker på programknappen och det inte kan vara den aktiva kategorin.

`CMFCRibbonBar::GetApplicationButton`

Hämtar en pekare till programknappen.

CMFCRibbonApplicationButton* GetApplicationButton() const;

Returvärde

En pekare till programknappen. eller NULL om knappen inte har angetts.

`CMFCRibbonBar::GetCaptionHeight`

Hämtar höjden på undertextområdet för menyfliksområdet.

int GetCaptionHeight() const;

Returvärde

Höjden, i bildpunkter, på textområdet för menyfliksområdet.

Anmärkningar

`CMFCRibbonBar::GetCategory`

Hämtar en pekare till menyfliksområdets kategori vid det angivna indexet.

CMFCRibbonCategory* GetCategory(int nIndex) const;

Parametrar

nIndex
[i] Det nollbaserade indexet för en menyflikskategori i listan över menyflikskategorier som finns i menyfliksområdet.

Returvärde

En pekare till menyfliksområdets kategori vid det angivna indexet. annars NULL om nIndex var utom räckhåll.

`CMFCRibbonBar::GetCategoryCount`

Hämtar antalet menyflikskategorier i menyfliksområdet.

int GetCategoryCount() const;

Returvärde

Antalet menyflikskategorier i menyfliksområdet.

`CMFCRibbonBar::GetCategoryHeight`

Hämtar höjden på kategorin.

int GetCategoryHeight() const;

Returvärde

Kategorins höjd.

Anmärkningar

Kategorihöjden innehåller kategoriflikens höjd.

`CMFCRibbonBar::GetCategoryIndex`

Hämtar indexet för den angivna menyfliksområdets kategori.

int GetCategoryIndex(CMFCRibbonCategory* pCategory) const;

Parametrar

pCategory
[i] Pekare till en menyfliksområdeskategori.

Returvärde

Det nollbaserade indexet för en menyflikskategori som anges av pCategory; eller -1 om menyfliksområdets kategori inte hittas.

`CMFCRibbonBar::GetContextName`

Hämtar namnet på kontextkategorirubriken som anges av ett kontext-ID.

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

Parametrar

uiContextID
[i] Ett kontext-ID för menyfliksområdeskategori.

strName
[ut] Namnet på en kontextkategorirubrik.

Returvärde

TRUE om metoden lyckades. annars FALSE om uiContextID var noll eller om beskrivningen av kontextkategorin inte hittades.

`CMFCRibbonBar::GetDroppedDown`

Hämtar menyfliksområdet som för närvarande är nedsläppt.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Returvärde

Menyflikselementet som för närvarande är nedsläppt. eller NULL om inget menyflikselement för närvarande är nedsläppt.

Anmärkningar

`CMFCRibbonBar::GetElementsByID`

Hämtar en matris med pekare till alla menyflikselement som har ett specifikt kommando-ID.

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

Parametrar

uiCmdID
[i] Kommando-ID för ett menyfliksområde.

arButtons
[ut] En matris med pekare till menyfliksområdeselement.

Anmärkningar

Flera menyflikselement kan ha samma kommando-ID eftersom vissa menyflikselement kan kopieras till verktygsfältet för snabbåtkomst.

`CMFCRibbonBar::GetHideFlags`

Hämtar flaggorna som anger hur mycket av menyfliksområdet som visas.

DWORD GetHideFlags() const;

Returvärde

Flaggorna som anger hur mycket av menyfliksområdet som visas.

Anmärkningar

I följande tabell visas en möjlig kombination av flaggor för returvärdet:

Flagga	Beskrivning
`AFX_RIBBONBAR_HIDE_ELEMENTS`	Menyfliksområdet minimeras lodrätt och endast kategoriflikarna, huvudknappen och verktygsfältet för snabbåtkomst visas.
`AFX_RIBBONBAR_HIDE_ALL`	Bredden på menyfliksområdet är mindre än den minsta bredden och är helt dold.

`CMFCRibbonBar::GetItemIDsList`

Hämtar kommando-ID:t för den angivna samlingen med menyflikselement i menyfliksområdet.

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

Parametrar

lstItems
[ut] Listan över kommando-ID:er för menyfliksområdeselement som finns i menyfliksområdet.

bHiddenOnly
[i] TRUE att exkludera menyflikselement som visas. FALSE att inkludera alla menyflikselement i menyfliksområdet.

Anmärkningar

`CMFCRibbonBar::GetKeyboardNavigationLevel`

Hämtar den aktuella navigeringsnivån när användaren trycker på de knappbeskrivningar som finns i menyfliksområdet.

int GetKeyboardNavigationLevel() const;

Returvärde

Den aktuella navigeringsnivån när användaren trycker på de knappbeskrivningar som finns i menyfliksområdet. I följande tabell visas möjliga returvärden:

Värde	Beskrivning
-1	Knappbeskrivningar visas inte.
0	Knappbeskrivningar visas.
1	Användaren har tryckt på en knappbeskrivning som visas.

Anmärkningar

`CMFCRibbonBar::GetKeyboardNavLevelCurrent`

Hämtar det aktuella tangentbordsnavigeringsobjektet i menyfliksområdet.

CObject* GetKeyboardNavLevelCurrent() const;

Returvärde

Det aktuella tangentbordsnavigeringsobjektet i menyfliksområdet. annars NULL om inget objekt för närvarande visar knappbeskrivningar.

Anmärkningar

Det objekt som för närvarande visar knappbeskrivningar är det aktuella tangentbordsnavigeringsobjektet.

`CMFCRibbonBar::GetKeyboardNavLevelParent`

Hämtar det överordnade tangentbordsnavigeringsobjektet i menyfliksområdet.

CObject* GetKeyboardNavLevelParent() const;

Returvärde

Det överordnade tangentbordsnavigeringsobjektet i menyfliksområdet. annars NULL.

Anmärkningar

När användaren trycker på en knappbeskrivning i menyfliksområdet blir det aktuella navigeringsobjektet för tangentbordet det överordnade navigeringsobjektet för tangentbordet.

`CMFCRibbonBar::GetMainCategory`

Hämtar en pekare till huvudkategorin i menyfliksområdet.

CMFCRibbonCategory* GetMainCategory() const;

Returvärde

En pekare till huvudkategorin i menyfliksområdet.

Anmärkningar

Huvudkategorin för menyfliksområdet innehåller huvudpanelen i menyfliksområdet.

`CMFCRibbonBar::GetQATCommandsLocation`

Hämtar visningsrektangeln för kommandoavsnittet i verktygsfältet för snabbåtkomst.

CRect GetQATCommandsLocation() const;

Returvärde

Visningsrektangeln för kommandoavsnittet i verktygsfältet för snabbåtkomst.

Anmärkningar

Kommandoavsnittet i visningsrektangeln innehåller inte anpassningsknappen.

`CMFCRibbonBar::GetQATDroppedDown`

Hämtar en pekare till menyflikselementet i verktygsfältet för snabbåtkomst som har popup-menyn nedrullningsad.

CMFCRibbonBaseElement* GetQATDroppedDown();

Returvärde

En pekare till menyflikselementet i verktygsfältet för snabbåtkomst som har popup-menyn nedrullningsad.

Anmärkningar

`CMFCRibbonBar::GetQuickAccessCommands`

Hämtar en lista över kommando-ID:t för menyfliksområdets element i verktygsfältet för snabbåtkomst.

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

Parametrar

lstCommands
[ut] Listan över kommando-ID:er för menyfliksområdets element i verktygsfältet för snabbåtkomst.

Anmärkningar

Listan innehåller inte menyflikselement som är kontrollavgränsare.

`CMFCRibbonBar::GetQuickAccessToolbarLocation`

Hämtar visningsrektangeln för verktygsfältet för snabbåtkomst.

CRect GetQuickAccessToolbarLocation() const;

Returvärde

Visningsrektangeln för verktygsfältet för snabbåtkomst.

Anmärkningar

`CMFCRibbonBar::GetTabTrancateRatio`

Hämtar procentstorleksminskningen i visningsbredden för kategoriflikarna.

int GetTabTrancateRatio() const;

Returvärde

Procentstorleksminskningen i visningsbredden för kategoriflikarna.

Anmärkningar

Kategoriflikar minskas i bredd när det inte finns tillräckligt med bredd i menyfliksområdet.

`CMFCRibbonBar::GetTooltipFixedWidthLargeImage`

Hämtar den stora storleken på knappbeskrivningsbredden för menyfliksområdet.

int GetTooltipFixedWidthLargeImage() const;

Returvärde

Den stora storleken på knappbeskrivningsbredden i bildpunkter.

Anmärkningar

Om den stora storleken på knappbeskrivningsbredden är 0 varierar bredden.

`CMFCRibbonBar::GetTooltipFixedWidthRegular`

Hämtar den vanliga storleken på knappbeskrivningsbredden för menyfliksområdet.

int GetTooltipFixedWidthRegular() const;

Returvärde

Den vanliga storleken på knappbeskrivningsbredden i bildpunkter.

Anmärkningar

Om den vanliga storleken på knappbeskrivningsbredden är 0 varierar bredden.

`CMFCRibbonBar::GetVisibleCategoryCount`

Hämtar antalet synliga kategorier i menyfliksområdet.

int GetVisibleCategoryCount() const;

Returvärde

Antalet synliga kategorier i menyfliksområdet.

Anmärkningar

`CMFCRibbonBar::HideAllContextCategories`

Döljer alla kontextkategorier i menyfliksområdet.

BOOL HideAllContextCategories();

Returvärde

TRUE om minst en kontextkategori var dold. annars FALSE.

Anmärkningar

Om en kontextkategori är aktiv återställs den aktiva kategorin till den första synliga kategorin i kategorilistan.

`CMFCRibbonBar::HideKeyTips`

Döljer alla knappbeskrivningar i menyfliksområdet.

void HideKeyTips();

Anmärkningar

`CMFCRibbonBar::HitTest`

Hämtar en pekare till menyfliksområdet som anges av platsen för punkten.

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

Parametrar

point
[i] Platsen för punkten i koordinaterna för menyfliksområdet.

bCheckActiveCategory
[i] TRUE för att söka i den aktiva kategorin; FALSE att inte söka i den aktiva kategorin.

bCheckPanelCaption
[i] TRUE för att testa beskrivningen av menyfliksområdet med den punkt som finns i den. FALSE att inte testa beskrivningen av menyfliksområdet med den punkt som finns i den. Mer information finns i avsnittet Kommentarer.

Returvärde

En pekare till menyflikselementet som finns på den angivna punkten. annars NULL om punkten inte finns i ett menyflikselement.

Anmärkningar

Beskrivningen av menyfliksområdet med den punkt som finns i den testas inte om inte parametern bCheckActiveCategory är TRUE.

`CMFCRibbonBar::IsKeyTipEnabled`

Anger om funktionen för knappbeskrivningar är aktiverad.

BOOL IsKeyTipEnabled() const;

Returvärde

TRUE om funktionen för knappbeskrivningar är aktiverad. annars FALSE.

`CMFCRibbonBar::IsMainRibbonBar`

Anger om menyfliksområdet är det primära menyfliksområdet.

virtual BOOL IsMainRibbonBar() const;

Returvärde

Returnerar alltid TRUE.

Anmärkningar

Som standard returnerar den här metoden alltid TRUE. Åsidosätt den här metoden för att ange om menyfliksområdet är det primära menyfliksområdet.

`CMFCRibbonBar::IsPrintPreviewEnabled`

Anger om funktionen Förhandsgranskning är aktiverad.

BOOL IsPrintPreviewEnabled() const;

Returvärde

TRUE om funktionen Förhandsgranskning är aktiverad. annars FALSE.

`CMFCRibbonBar::IsQATEmpty`

Anger om verktygsfältet för snabbåtkomst innehåller kommandoknappar.

BOOL IsQATEmpty() const;

Returvärde

TRUE om verktygsfältet för snabbåtkomst innehåller kommandoknappar. annars FALSE.

Anmärkningar

`CMFCRibbonBar::IsQuickAccessToolbarOnTop`

Anger om verktygsfältet för snabbåtkomst finns över eller under menyfliksområdet.

BOOL IsQuickAccessToolbarOnTop() const;

Returvärde

TRUE om verktygsfältet för snabbåtkomst finns över menyfliksområdet. FALSE om verktygsfältet för snabbåtkomst finns under menyfliksområdet.

`CMFCRibbonBar::IsReplaceFrameCaption`

Anger om menyfliksområdet ersätter eller är under rubriken för huvudramsfönstret.

BOOL IsReplaceFrameCaption() const;

Returvärde

TRUE om menyfliksområdet ersätter beskrivningen av huvudramsfönstret. FALSE om menyfliksområdet är under rubriken för huvudramsfönstret.

`CMFCRibbonBar::IsShowGroupBorder`

Anger om knappgrupper som finns i menyfliksområdet visar en gruppkantlinje.

virtual BOOL IsShowGroupBorder(CMFCRibbonButtonsGroup* pGroup) const;

Parametrar

pGroup
[i] Den här parametern används inte.

Returvärde

Returnerar alltid FALSE.

Anmärkningar

Som standard returnerar den här metoden alltid FALSE. Åsidosätt den här metoden för att ange om knappgrupper som finns i menyfliksområdet visar en gruppkantlinje.

`CMFCRibbonBar::IsToolTipDescrEnabled`

Anger om knappbeskrivningar är aktiverade.

BOOL IsToolTipDescrEnabled() const;

Returvärde

TRUE om beskrivningar av knappbeskrivningar är aktiverade. FALSE om beskrivningar av knappbeskrivningar är inaktiverade.

Anmärkningar

Beskrivningar av knappbeskrivningar är ytterligare beskrivande text som visas med knappbeskrivningstexten.

`CMFCRibbonBar::IsToolTipEnabled`

Anger om knappbeskrivningar är aktiverade eller inaktiverade för menyfliksområdet.

BOOL IsToolTipEnabled() const;

Returvärde

TRUE om knappbeskrivningar är aktiverade. FALSE om knappbeskrivningar är inaktiverade.

`CMFCRibbonBar::IsTransparentCaption`

Anger om visningen är inställd för Windows Aero-färgschemat.

BOOL IsTransparentCaption() const;

Returvärde

TRUE om färgschemat är Windows Aero; annars FALSE.

Anmärkningar

`CMFCRibbonBar::OnClickButton`

Den här metoden behålls för bakåtkompatibilitet med befintliga program och bör inte användas för ny utveckling.

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

Parametrar

pButton
[i] Pekare till knappen som klickades.

point
[i] Den här parametern används inte.

Anmärkningar

`CMFCRibbonBar::OnEditContextMenu`

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

Parametrar

[i] pEdit
[i] point

Anmärkningar

`CMFCRibbonBar::OnRTLChanged`

Anropas av ramverket när layouten ändrar riktning.

virtual void OnRTLChanged(BOOL bIsRTL);

Parametrar

bIsRTL
[in] TRUE om layouten är höger-till-vänster; FALSE om layouten är från vänster till höger.

Anmärkningar

Den här metoden justerar layouten för alla kontroller i menyfliksområdet för den nya layoutriktningen.

`CMFCRibbonBar::OnSetAccData`

Den här metoden är intern i Ramverket och är inte avsedd att anropas från användarkoden.

BOOL OnSetAccData(long lVal);

Parametrar

long lVal Indexet för det tillgängliga objektet.

Returvärde

S_OK om det lyckas. annars FALSE eller S_FALSE.

Anmärkningar

`CMFCRibbonBar::OnShowRibbonContextMenu`

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

Parametrar

[i] pWnd
[i] x
[i] y
[i] pHit

Returvärde

Anmärkningar

`CMFCRibbonBar::OnShowRibbonQATMenu`

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

Parametrar

[i] pWnd
[i] x
[i] y
[i] pHit

Returvärde

Anmärkningar

`CMFCRibbonBar::OnSysKeyDown`

Anropas av ramverket när användaren trycker på F10 eller håller ned ALT- och trycker sedan på en annan nyckel.

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

Parametrar

pFrameWnd
[i] Pekare mot det överordnade huvudramsfönstret i menyfliksområdet.

wParam
[i] Virtuell nyckelkod för den nyckel som trycks in.

lParam
[i] Tangentbordstillståndsflaggor när tangenten trycktes in.

Returvärde

TRUE om tangenttryckningshändelsen bearbetades. annars FALSE.

Anmärkningar

`CMFCRibbonBar::OnSysKeyUp`

Anropas av ramverket när användaren släpper nyckeln F10, ALT- eller en nyckel som trycktes ned när ALT--tangenten hölls nere.

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

Parametrar

pFrameWnd
[i] Pekare mot det överordnade huvudramsfönstret i menyfliksområdet.

wParam
[i] Kod för virtuell nyckel för nyckeln som släpps.

lParam
[i] Den här parametern används inte.

Returvärde

TRUE om tangenttryckningshändelsen bearbetades. annars FALSE.

Anmärkningar

`CMFCRibbonBar::PopTooltip`

Tar bort en knappbeskrivning från vyn.

void PopTooltip();

Anmärkningar

`CMFCRibbonBar::PreTranslateMessage`

Avgör om det angivna meddelandet bearbetas av menyfliksområdet.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parametrar

pMsg
[i] Pekare mot ett meddelande.

Returvärde

TRUE om meddelandet bearbetades av menyfliksområdet. annars FALSE.

Anmärkningar

`CMFCRibbonBar::RecalcLayout`

Justerar layouten för alla kontroller i menyfliksområdet.

virtual void RecalcLayout();

Anmärkningar

Efter layoutjusteringen uppdateras visningen av menyfliksområdet.

`CMFCRibbonBar::RemoveAllCategories`

Tar bort alla menyflikskategorier från menyfliksområdet.

void RemoveAllCategories();

Anmärkningar

Den här metoden tar bort alla kategorier i menyfliksområdet från minnet och från kategorilistan.

`CMFCRibbonBar::RemoveAllFromTabs`

Tar bort alla menyflikselement från flikområdet.

void RemoveAllFromTabs();

Anmärkningar

Använd den här funktionen om du vill ta bort alla element som du har lagt till i flikområdet med hjälp av CMFCRibbonBar::AddToTabs metod.

`CMFCRibbonBar::RemoveCategory`

Tar bort den angivna menyfliksområdets kategori från menyfliksområdet.

BOOL RemoveCategory(int nIndex);

Parametrar

nIndex
[i] Det nollbaserade indexet för en kategori i listan över menyflikskategorier som finns i menyfliksområdet.

Returvärde

TRUE om den angivna menyflikskategorin har tagits bort. annars FALSE.

Anmärkningar

Den angivna bandkategorin tas bort från minnet och från kategorilistan.

`CMFCRibbonBar::SetActiveCategory`

Anger den angivna bandkategorin som den aktiva kategorin.

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

Parametrar

pCategory
[i] En menyfliksområdeskategori som finns i menyfliksområdet.

bForceRestore
[i] TRUE för att maximera menyfliksområdet om det minimeras. FALSE för att visa den aktiva kategorin i ett popup-fönster om menyfliksområdet minimeras.

Returvärde

TRUE om den angivna kategorin angavs som den aktiva kategorin. annars FALSE.

Anmärkningar

Huvudkategorin för menyfliksområdet kan inte vara den aktiva kategorin.

Om den kategori som anges av pCategory inte visas kan den inte anges som den aktiva kategorin.

`CMFCRibbonBar::SetActiveMDIChild`

Kopplar systemknapparna i menyfliksområdet som tillhör ett underordnat MDI-fönster (multiple-document interface) till det angivna underordnad MDI-fönstret.

void SetActiveMDIChild(CWnd* pWnd);

Parametrar

pWnd
[i] Pekare till ett underordnat MDI-fönster.

Anmärkningar

`CMFCRibbonBar::SetApplicationButton`

Tilldelar en menyfliksknapp för program till menyfliksområdet.

void SetApplicationButton(
    CMFCRibbonApplicationButton* pButton,
    CSize sizeButton);

Parametrar

pButton
[i] En pekare till programmets menyfliksområdesknapp.

sizeButton
[i] Storleken på menyfliksknappen för programmet.

Anmärkningar

Knappen för programfliksområdet är en stor rundad knapp i det övre vänstra hörnet av menyfliksområdet.

Exempel

I följande exempel visas hur du använder metoden SetApplicationButton i klassen CMFCRibbonBar.

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

Anger knappbeskrivningarna för alla menyflikselement som har det angivna kommando-ID:t.

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

Parametrar

uiCmdID
[i] Kommando-ID för ett menyflikselement.

lpszKeys
[i] Nyckelbeskrivningen.

lpszMenuKeys
[i] Knappbeskrivning på menyn.

Returvärde

TRUE om knappbeskrivningarna för minst ett menyflikselement har angetts. annars FALSE.

Anmärkningar

Den valfria menyknappbeskrivningen är för menyflikselement med en delad knapp som öppnar en popup-meny.

`CMFCRibbonBar::SetKeyboardNavigationLevel`

Anger tangentbordsnavigeringsnivå när användaren trycker på knappbeskrivningarna som finns i menyfliksområdet.

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

Parametrar

pLevel
[i] Pekare till det aktuella tangentbordsnavigeringsobjektet.

bSetFocus
[i] TRUE för att ställa in tangentbordets fokus på menyfliksområdet.

Anmärkningar

Tangentbordsnavigering i menyfliksområdet startar när användaren trycker på ALT- eller F10-tangenten. Användaren väljer nästa navigeringsnivå genom att trycka på en knappbeskrivning i menyfliksområdet. Användaren kan återgå till föregående navigeringsnivå genom att trycka på escape-tangenten.

`CMFCRibbonBar::SetMaximizeMode`

Justerar menyfliksområdet när fönsterstorleken för ett underordnat MDI-fönster (multiple-document interface) går in i eller lämnar det maximerade tillståndet.

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

Parametrar

bMax
[i] TRUE för att visa systemknapparna för ett underordnat MDI-fönster i menyfliksområdet. FALSE för att ta bort systemknapparna för ett underordnat MDI-fönster från menyfliksområdet.

pWnd
[i] Pekare mot huvudramsfönstret för menyfliksområdet.

Anmärkningar

Menyfliksområdet visar systemknappar för ett underordnat MDI-fönster på flikraden när ett underordnat MDI-fönster maximeras.

`CMFCRibbonBar::SetQuickAccessCommands`

Lägger till ett eller flera menyflikselement i verktygsfältet Snabbåtkomst.

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

Parametrar

lstCommands
[i] Listan över kommandon som ska placeras i verktygsfältet Snabbåtkomst.

bRecalcLayout
[i] TRUE om du vill rita om menyfliksområdet när du har lagt till menyflikselementen. FALSE annars.

Exempel

I följande exempel visas hur du använder metoden SetQuickAccessCommands i klassen CMFCRibbonBar.

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

Anger standardtillståndet för verktygsfältet för snabbåtkomst.

void SetQuickAccessDefaultState(const CMFCRibbonQuickAccessToolBarDefaultState& state);

Parametrar

state
[i] Standardtillståndet för verktygsfältet för snabbåtkomst.

Anmärkningar

Verktygsfältstillståndet för snabbåtkomst innehåller en lista över kommandon och deras synlighet.

Exempel

I följande exempel visas hur du använder metoden SetQuickAccessDefaultState i klassen CMFCRibbonBar.

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`

Placerar verktygsfältet för snabbåtkomst ovanför eller under menyfliksområdet.

void SetQuickAccessToolbarOnTop(BOOL bOnTop);

Parametrar

bOnTop
[i] TRUE för att placera verktygsfältet för snabbåtkomst ovanför menyfliksområdet. FALSE för att placera verktygsfältet för snabbåtkomst under menyfliksområdet.

`CMFCRibbonBar::SetTooltipFixedWidth`

Anger de vanliga och stora storlekarna på knappbeskrivningsuppsättningens fasta bredder för menyfliksområdet.

void SetTooltipFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parametrar

nWidthRegular
[i] Bredden i bildpunkter för en vanlig knappbeskrivning med fast storlek.

nWidthLargeImage
[i] Bredden i bildpunkter för en stor knappbeskrivning med fast storlek.

Anmärkningar

Om du anger en parameter till 0 varierar motsvarande bredd.

`CMFCRibbonBar::ShowCategory`

Visar eller döljer den angivna menyfliksområdets kategori.

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

Parametrar

nIndex
[i] Indexet för menyfliksområdets kategori.

bShow
[i] Om TRUEvisar du menyfliksområdets kategori. annars döljer du menyfliksområdets kategori.

`CMFCRibbonBar::ShowContextCategories`

Visar eller döljer de kontextkategorier som har det angivna ID:t.

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

Parametrar

uiContextID
[i] Kontextkategori-ID.

bShow
[i] Om TRUEvisar du de kategorier som har det angivna ID:t. Annars döljer du de kategorier som har det angivna ID:t.

`CMFCRibbonBar::ShowKeyTips`

Visar knappbeskrivningarna för varje menyflikselement i menyfliksområdet.

void ShowKeyTips();

Anmärkningar

`CMFCRibbonBar::ToggleMimimizeState`

Växlar menyfliksområdet mellan minimerade och maximerade tillstånd.

void ToggleMimimizeState();

Anmärkningar

Felstavningen i metodnamnet är ett känt problem.

I det minimerade tillståndet är menyfliksområdets kontroll dold och endast flikarna visas. När användaren klickar på en flik visas menyflikskontrollen som ett popup-fönster. Fönstret stängs när användaren klickar bort eller kör ett kommando.

`CMFCRibbonBar::TranslateChar`

Avgör om den angivna tangenttryckningsteckenkoden bearbetas av menyfliksområdet.

virtual BOOL TranslateChar(UINT nChar);

Parametrar

nChar
[i] En teckenkod för tangenttryckning för användare.

Returvärde

TRUE om teckenkoden bearbetades av menyfliksområdet. annars FALSE.

Anmärkningar

Med knappbeskrivningsfunktionen kan användarna navigera i menyfliksområdet med hjälp av tangentbordet.

`CMFCRibbonBar::GetFocused`

Returnerar ett fokuserat element.

virtual CMFCRibbonBaseElement* GetFocused();

Returvärde

En pekare till ett fokuserat element eller NULL.

Anmärkningar

`CMFCRibbonBar::IsWindows7Look`

Anger om menyfliksområdet har ett Windows 7-utseende (liten rektangulär programknapp).

BOOL IsWindows7Look() const;

Returvärde

TRUE om menyfliksområdet har en Windows 7-look; annars FALSE.

Anmärkningar

`CMFCRibbonBar::LoadFromResource`

Överbelastad. Läser in ett bandfält från programresurser.

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

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

Parametrar

uiXMLResID
Anger resurs-ID för XML-sträng med information om menyfliksområdet.

lpszResType
Anger vilken typ av resurs som finns på uiXMLResID.

hInstance
Hantera till modulen vars körbara fil innehåller resursen. Om hInstance är NULLläser systemet in resursen från modulen som användes för att skapa den aktuella processen.

lpszXMLResID
Anger resurs-ID (i strängform) med information om menyfliksområdet.

Returvärde

TRUE om belastningen lyckas. annars FALSE.

Anmärkningar

`CMFCRibbonBar::SaveToXMLBuffer`

Sparar menyfliksområdet i en buffert.

UINT SaveToXMLBuffer(LPBYTE* ppBuffer) const;

Parametrar

ppBuffer
När den här funktionen returneras pekar ppBuffer på en buffert som allokeras av den här metoden och innehåller information om menyfliksområdet i XML-format.

Returvärde

TRUE om det lyckas. annars FALSE.

Anmärkningar

`CMFCRibbonBar::SaveToXMLFile`

Sparar menyfliksområdet i en XML-fil.

BOOL SaveToXMLFile(LPCTSTR lpszFilePath) const;

Parametrar

lpszFilePath
Anger utdatafilen.

Returvärde

TRUE om det lyckas. annars FALSE.

Anmärkningar

`CMFCRibbonBar::SetWindows7Look`

Aktiverar eller inaktiverar ett Windows 7-utseende (liten rektangulär programknapp) för menyfliksområdet.

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

Parametrar

bWindows7Look
TRUE anger ett Windows 7-utseende. FALSE annars.

bRecalc
TRUE beräknar om menyfliksområdets layout. FALSE annars.

Anmärkningar

Se även

hierarkidiagram
klasser
CPane klass
CMFCRibbonCategory klass
CMFCRibbonPanel klass
CMFCRibbonBaseElement klass
genomgång: Uppdatera MFC Scribble-programmet

Dela via

CMFCRibbonBar-klass

Syntax

Medlemmar

Offentliga konstruktorer

Offentliga metoder

Anmärkningar

Arvshierarki

Krav

CMFCRibbonBar::ActivateContextCategory

Parametrar

Returvärde

CMFCRibbonBar::AddCategory

Parametrar

Returvärde

Anmärkningar

Exempel

CMFCRibbonBar::AddContextCategory

Parametrar

Returvärde

Anmärkningar

CMFCRibbonBar::AddMainCategory

Parametrar

Returvärde

Anmärkningar

Exempel

CMFCRibbonBar::AddPrintPreviewCategory

Returvärde

Anmärkningar

CMFCRibbonBar::AddQATOnlyCategory

Parametrar

Returvärde

Anmärkningar

CMFCRibbonBar::AddToTabs

Parametrar

Anmärkningar

CMFCRibbonBar::CMFCRibbonBar

Parametrar

Anmärkningar

CMFCRibbonBar::Create

Parametrar

Returvärde

Anmärkningar

Exempel

CMFCRibbonBar::CreateEx

Parametrar

Returvärde

Anmärkningar

CMFCRibbonBar::DeactivateKeyboardFocus

Parametrar

Anmärkningar

CMFCRibbonBar::DrawMenuImage

Parametrar

Returvärde

Anmärkningar

CMFCRibbonBar::DWMCompositionChanged

Anmärkningar

CMFCRibbonBar::EnableKeyTips

Parametrar

Anmärkningar

CMFCRibbonBar::EnablePrintPreview

Parametrar

Anmärkningar

CMFCRibbonBar::EnableToolTips

Parametrar

Anmärkningar

CMFCRibbonBar::FindByData

Parametrar

Returvärde

Anmärkningar

CMFCRibbonBar::FindByID

Parametrar

Returvärde

Anmärkningar

CMFCRibbonBar::FindCategoryIndexByData

Parametrar

Returvärde

CMFCRibbonBar::ForceRecalcLayout

Anmärkningar

CMFCRibbonBar::GetActiveCategory

`CMFCRibbonBar`-klass

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