Freigeben über


CMFCRibbonBar-Klasse

Die CMFCRibbonBar-Klasse implementiert eine Menübandleiste, die der in Office 2007 verwendeten ähnlich ist.

Ausführliche Informationen finden Sie im Quellcode im Ordner mfc Ihrer Visual Studio-Installation. Beispiel: %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Syntax

class CMFCRibbonBar : public CPane

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCRibbonBar::CMFCRibbonBar Der Standardkonstruktor.

Öffentliche Methoden

Name Beschreibung
CMFCRibbonBar::ActivateContextCategory Aktiviert eine bereits angezeigte Kontextkategorie.
CMFCRibbonBar::AddCategory Fügt dem Menüband eine neue Menübandkategorie hinzu.
CMFCRibbonBar::AddContextCategory Fügt eine Kontextkategorie hinzu.
CMFCRibbonBar::AddMainCategory Fügt dem Menüband eine neue Hauptkategorie hinzu.
CMFCRibbonBar::AddPrintPreviewCategory
CMFCRibbonBar::AddQATOnlyCategory
CMFCRibbonBar::AddToTabs Fügt der rechten Seite einer Menübandleiste ein Menübandelement hinzu.
CMFCRibbonBar::CreateEx Erstellt eine Steuerelementleiste und fügt sie an das CPane Objekt an. (Überschreibt CPane::CreateEx.)
CMFCRibbonBar::Create Erstellt ein Menübandsteuerelement und fügt es einer Menübandleiste hinzu.
CMFCRibbonBar::DeactivateKeyboardFocus
CMFCRibbonBar::DrawMenuImage
CMFCRibbonBar::DWMCompositionChanged
CMFCRibbonBar::EnableKeyTips Aktiviert bzw. deaktiviert Zugriffstasteninfos für das Menübandsteuerelement.
CMFCRibbonBar::EnablePrintPreview Aktivieren Sie die Registerkarte "Seitenansicht ".
CMFCRibbonBar::EnableToolTips Aktiviert oder deaktiviert QuickInfos und QuickInfo-Beschreibungen auf der Menübandleiste.
CMFCRibbonBar::FindByData Sucht anhand der vom Benutzer angegebenen Daten nach einem Menübandelement.
CMFCRibbonBar::FindByID Sucht ein Menübandelement mit der angegebenen Befehls-ID.
CMFCRibbonBar::FindCategoryIndexByData Sucht den Index der Menübandkategorie, die die benutzerdefinierten Daten enthält.
CMFCRibbonBar::ForceRecalcLayout
CMFCRibbonBar::GetActiveCategory Ruft einen Zeiger auf eine aktive Kategorie ab.
CMFCRibbonBar::GetCaptionHeight Gibt die Beschriftungshöhe zurück. (Überschreibt CBasePane::GetCaptionHeight.)
CMFCRibbonBar::GetCategory Ruft den Zeiger auf eine Kategorie ab, die sich an einem angegebenen Index befindet.
CMFCRibbonBar::GetCategoryCount Ruft die Anzahl der Menübandkategorien in der Menübandleiste ab.
CMFCRibbonBar::GetCategoryHeight
CMFCRibbonBar::GetCategoryIndex Gibt den Index einer Menübandkategorie zurück.
CMFCRibbonBar::GetContextName Ruft den Namen der Kontextkategoriebeschriftung ab, die Sie mit einer ID angeben.
CMFCRibbonBar::GetDroppedDown
CMFCRibbonBar::GetElementsByID Ruft ein Array ab, das die Zeiger auf alle Menübandelemente enthält, die die angegebene ID aufweisen.
CMFCRibbonBar::GetApplicationButton Ruft einen Zeiger auf eine Menübandschaltfläche ab.
CMFCRibbonBar::GetFocused Gibt ein Fokuselement zurück.
CMFCRibbonBar::GetHideFlags
CMFCRibbonBar::GetItemIDsList
CMFCRibbonBar::GetKeyboardNavigationLevel
CMFCRibbonBar::GetKeyboardNavLevelCurrent
CMFCRibbonBar::GetKeyboardNavLevelParent
CMFCRibbonBar::GetMainCategory Gibt einen Zeiger auf die aktuell ausgewählte Menübandkategorie zurück.
CMFCRibbonBar::GetQATCommandsLocation
CMFCRibbonBar::GetQATDroppedDown
CMFCRibbonBar::GetQuickAccessCommands Füllt eine Liste aus, die die Befehls-IDs aller Elemente in der Symbolleiste für den Schnellzugriff enthält.
CMFCRibbonBar::GetQuickAccessToolbarLocation
CMFCRibbonBar::GetTabTrancateRatio
CMFCRibbonBar::GetTooltipFixedWidthLargeImage
CMFCRibbonBar::GetTooltipFixedWidthRegular
CMFCRibbonBar::GetVisibleCategoryCount
CMFCRibbonBar::HideAllContextCategories Blendet alle aktiven und sichtbaren Kategorien aus.
CMFCRibbonBar::HideKeyTips
CMFCRibbonBar::HitTest Sucht einen Zeiger auf das Menübandelement, das sich am angegebenen Punkt der Clientkoordinaten des Menübands befindet.
CMFCRibbonBar::IsKeyTipEnabled Legt fest, ob die Zugriffstasteninfos aktiviert sind.
CMFCRibbonBar::IsMainRibbonBar
CMFCRibbonBar::IsPrintPreviewEnabled Bestimmt, ob die Registerkarte "Seitenansicht " aktiviert ist.
CMFCRibbonBar::IsQATEmpty
CMFCRibbonBar::IsQuickAccessToolbarOnTop Gibt an, ob sich die Symbolleiste für den Schnellzugriff oberhalb der Menübandleiste befindet.
CMFCRibbonBar::IsReplaceFrameCaption Legt fest, ob die Menübandleiste die Beschriftung des Hauptrahmens ersetzt oder unterhalb des Hauptrahmens hinzugefügt wird.
CMFCRibbonBar::IsShowGroupBorder
CMFCRibbonBar::IsToolTipDescrEnabled Legt fest, ob QuickInfo-Beschreibungen aktiviert sind.
CMFCRibbonBar::IsToolTipEnabled Legt fest, ob die QuickInfos für die Menübandleiste aktiviert sind.
CMFCRibbonBar::IsTransparentCaption
CMFCRibbonBar::IsWindows7Look Gibt an, ob das Menüband im Stil von Windows 7 angezeigt wird (kleine rechteckige Anwendungsschaltfläche).
CMFCRibbonBar::LoadFromResource Überladen. Lädt eine Menübandleiste aus den Anwendungsressourcen.
CMFCRibbonBar::OnClickButton
CMFCRibbonBar::OnEditContextMenu
CMFCRibbonBar::OnRTLChanged (Überschreibt CPane::OnRTLChanged.)
CMFCRibbonBar::OnSetAccData (Überschreibt CBasePane::OnSetAccData.)
CMFCRibbonBar::OnShowRibbonContextMenu
CMFCRibbonBar::OnShowRibbonQATMenu
CMFCRibbonBar::OnSysKeyDown
CMFCRibbonBar::OnSysKeyUp
CMFCRibbonBar::PopTooltip
CMFCRibbonBar::PreTranslateMessage (Überschreibt CBasePane::PreTranslateMessage.)
CMFCRibbonBar::RecalcLayout (Überschreibt CPane::RecalcLayout.)
CMFCRibbonBar::RemoveAllCategories Entfernt alle Menübandkategorien von der Menübandleiste.
CMFCRibbonBar::RemoveAllFromTabs Entfernt alle Menübandelemente aus dem Registerkartenbereich.
CMFCRibbonBar::RemoveCategory Entfernt die Menübandkategorie, die sich am angegebenen Index befindet.
CMFCRibbonBar::SaveToXMLBuffer Speichert die Menübandleiste in einem Puffer.
CMFCRibbonBar::SaveToXMLFile Speichert die Menübandleiste in einer XML-Datei.
CMFCRibbonBar::SetActiveCategory Legt eine angegebenen Menübandkategorie als aktiv fest.
CMFCRibbonBar::SetActiveMDIChild
CMFCRibbonBar::SetElementKeys Legt die angegebenen Zugriffstasteninfos für alle Menübandelemente fest, die über die angegebene Befehls-ID verfügen.
CMFCRibbonBar::SetApplicationButton Weist der Menübandleiste eine Anwendungsschaltfläche zu.
CMFCRibbonBar::SetKeyboardNavigationLevel
CMFCRibbonBar::SetMaximizeMode
CMFCRibbonBar::SetQuickAccessCommands Fügt der Symbolleiste für den Schnellzugriff eines oder mehrere Menübandelemente hinzu.
CMFCRibbonBar::SetQuickAccessDefaultState Gibt den Standardzustand für die Symbolleiste für den Schnellzugriff an.
CMFCRibbonBar::SetQuickAccessToolbarOnTop Positioniert die Symbolleiste für den Schnellzugriff oberhalb oder unterhalb der Menübandleiste.
CMFCRibbonBar::SetTooltipFixedWidth
CMFCRibbonBar::SetWindows7Look Aktiviert/deaktiviert das Menüband im Stil von Windows 7 (kleine rechteckige Anwendungsschaltfläche).
CMFCRibbonBar::ShowCategory Blendet die angegebene Menübandkategorie ein oder aus.
CMFCRibbonBar::ShowContextCategories Blendet die Kontextkategorien mit der angegebenen ID ein oder aus.
CMFCRibbonBar::ShowKeyTips
CMFCRibbonBar::ToggleMimimizeState Wechselt zwischen dem minimierten und maximierten Zustand der Menübandleiste.
CMFCRibbonBar::TranslateChar

Hinweise

Microsoft hat das Office Fluent-Menüband zusammen mit Microsoft Office 2007 eingeführt. Diese Menübandleiste ist nicht nur ein neues Steuerelement. Sie stellt auch eine neue Sichtweise der Benutzeroberfläche dar. Das Menüband ist ein Bereich mit einer Reihe von Registerkarten, die als „Kategorien“ bezeichnet werden. Jede Kategorie ist logisch in Menübandbereiche aufgeteilt, und jeder Bereich kann verschiedene Steuerelemente und Befehlsschaltflächen enthalten.

Die Elemente auf der Menübandleiste werden je nach Bedarf erweitert und reduziert, um den verfügbaren Platz optimal zu nutzen. Wenn ein Menübandbereich zum Beispiel nicht über ausreichend Platz verfügt, um alle Elemente anzuzeigen, wird er zu einer Menüschaltfläche, in dem untergeordnete Elemente in einem Popupmenü angezeigt werden. Die Menübandleiste verhält sich wie eine statische (unverankerte) Steuerleiste und kann am oberen Rand des Rahmens verankert werden.

Mit der CMFCRibbonStatusBar-Klasse können Sie eine Statusleiste implementieren, die der in Office 2007 verwendeten Statusleiste ähnelt. Eine Menübandkategorie enthält (und zeigt) eine Gruppe von Menübandbereichen an. Jeder Menübandbereich enthält ein oder mehrere Menübandelemente, die von CMFCRibbonBaseElement.

Informationen zum Hinzufügen einer Menübandleiste zu Ihrer vorhandenen MFC-Anwendung finden Sie unter Walkthrough: Updating the MFC Scribble Application.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCRibbonBar

Anforderungen

Header: afxribbonbar.h

CMFCRibbonBar::ActivateContextCategory

Aktiviert eine bereits angezeigte Kontextkategorie.

BOOL ActivateContextCategory(UINT uiContextID);

Parameter

uiContextID
[in] Die Kontextkategorie-ID.

Rückgabewert

TRUE wenn eine Kontextkategorie gefunden uiContextID und aktiviert wird; andernfalls FALSE.

CMFCRibbonBar::AddCategory

Erstellt und initialisiert eine neue Menübandkategorie für die Menübandleiste.

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

Parameter

lpszName
[in] Name der Menübandkategorie.

uiSmallImagesResID
[in] Ressourcen-ID der kleinen Bildliste für die Menübandkategorie.

uiLargeImagesResID
[in] Ressourcen-ID der großen Bildliste für die Menübandkategorie.

sizeSmallImage
[in] Gibt die Größe kleiner Bilder für die Menübandkategorie an.

sizeLargeImage
[in] Gibt die Größe großer Bilder für die Menübandkategorie an.

nInsertAt
[in] Nullbasierter Index des Kategoriespeicherorts.

pRTI
[in] Zeigen Sie auf eine CMFCRibbonCategory Klassenausführungsklasse , um zur Laufzeit dynamisch eine Menübandkategorie zu erstellen.

Rückgabewert

Ein Zeiger auf die neue Menübandkategorie, wenn die Methode erfolgreich war; andernfalls . NULL

Hinweise

Wenn der pRTI Parameter nicht NULLangegeben ist, wird die neue Menübandkategorie dynamisch mithilfe der Laufzeitklasse erstellt.

Beispiel

Im folgenden Beispiel wird die Verwendung der AddCategory Methode in der CMFCRibbonBar Klasse veranschaulicht.

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

CMFCRibbonBar::AddContextCategory

Erstellt und initialisiert eine neue Kontextkategorie für die Menübandleiste.

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

Parameter

lpszName
[in] Name der Kategorie.

lpszContextName
[in] Name der Beschriftung der Kontextkategorie.

uiContextID
[in] Kontext-ID.

clrContext
[in] Farbe der Beschriftung der Kontextkategorie.

uiSmallImagesResID
[in] Ressourcen-ID des kleinen Bilds einer Kontextkategorie.

uiLargeImagesResID
[in] Ressourcen-ID des großen Bilds einer Kontextkategorie.

sizeSmallImage
[in] Größe eines kleinen Bilds.

sizeLargeImage
[in] Größe eines großen Bilds.

pRTI
[in] Zeiger auf eine Laufzeitklasse.

Rückgabewert

Ein Zeiger auf die neu erstellte Kategorie oder NULL wenn die CreateObject Methode der pRTI angegebenen Kategorie nicht erstellt werden kann.

Hinweise

Verwenden Sie diese Funktion, um eine Kontextkategorie hinzuzufügen. Kontextkategorien sind ein spezieller Typ von Kategorie, der je nach aktuellem Anwendungskontext zur Laufzeit angezeigt oder ausgeblendet werden kann. Wenn der Benutzer beispielsweise ein Objekt auswählt, können Sie spezielle Registerkarten mit Kontextkategorien anzeigen, die Sie zum Ändern des bestimmten ausgewählten Objekts verwenden.

Die Farbe einer Kontextkategorie kann einen der folgenden Werte aufweisen:

  • 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

Erstellt eine neue Hauptmenübandkategorie für die Menübandleiste.

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

Parameter

lpszName
[in] Name der Hauptmenübandkategorie.

uiSmallImagesResID
[in] Ressourcen-ID kleiner Bilder.

uiLargeImagesResID
[in] Ressourcen-ID großer Bilder.

sizeSmallImage
[in] Die Größe kleiner Bilder.

sizeLargeImage
[in] Die Größe großer Bilder.

Rückgabewert

Zeigen Sie auf die neue Hauptmenübandkategorie, wenn die Methode erfolgreich war; andernfalls . NULL

Hinweise

Wenn bereits eine Hauptmenübandkategorie vorhanden ist, wird sie gelöscht.

Beispiel

Im folgenden Beispiel wird die Verwendung der AddMainCategory Methode in der CMFCRibbonBar Klasse veranschaulicht.

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

Erstellt eine Druckvorschaukategorie auf der Menübandleiste.

CMFCRibbonCategory* AddPrintPreviewCategory();

Rückgabewert

Ein Zeiger auf die neue Menübandkategorie, wenn die Methode erfolgreich war; andernfalls . NULL

Hinweise

Diese Methode erstellt eine Menübandkategorie und die Steuerelemente, die sie benötigt, um eine Druckvorschau bereitzustellen.

CMFCRibbonBar::AddQATOnlyCategory

Erstellt eine Symbolleistensymbolleistenkategorie für den Schnellzugriff.

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

Parameter

lpszName
[in] Name der Kategorie.

uiSmallImagesResID
[in] Ressourcen-ID der Bildliste für die Kategorie.

sizeSmallImage
[in] Größe von Bildern für Menübandelemente in der Kategorie.

Rückgabewert

Ein Zeiger auf die neue Kategorie, wenn die Methode erfolgreich war; andernfalls . NULL

Hinweise

Die Symbolleistensymbolleistenkategorie für den Schnellzugriff wird nur im Dialogfeld zum Anpassen der Symbolleiste für den Schnellzugriff verwendet.

CMFCRibbonBar::AddToTabs

Fügt das angegebene Menübandelement der Registerkartenzeile der Menübandleiste hinzu.

void AddToTabs(CMFCRibbonBaseElement* pElement);

Parameter

pElement
[in] Zeiger auf ein Menübandelement.

Hinweise

Das Menübandelement wird vor allen Systemschaltflächen positioniert.

CMFCRibbonBar::CMFCRibbonBar

Erstellt und initialisiert ein CMFCRibbonBar-Objekt.

CMFCRibbonBar(BOOL bReplaceFrameCaption = TRUE);

Parameter

bReplaceFrameCaption
[in] TRUE für die Menübandleiste, um die Beschriftung des Hauptrahmenfensters zu ersetzen; FALSE um die Menübandleiste unter der Beschriftung des Hauptrahmenfensters zu suchen.

Hinweise

CMFCRibbonBar::Create

Erstellt ein Fenster für die Menübandleiste.

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

Parameter

pParentWnd
[in] Zeigen Sie auf das übergeordnete Fenster für die Menübandleiste.

dwStyle
[in] Eine logische Kombination von Formatvorlagen für das neue Fenster.

nID
[in] ID des neuen Fensters.

Rückgabewert

TRUE wenn das Fenster erstellt wurde; andernfalls FALSE.

Hinweise

Beispiel

Im folgenden Beispiel wird die Verwendung der Create Methode der CMFCRibbonBar Klasse veranschaulicht.

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

CMFCRibbonBar::CreateEx

Erstellt ein Fenster für die Menübandleiste.

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

Parameter

pParentWnd
[in] Zeigen Sie auf das übergeordnete Fenster für die Menübandleiste.

dwCtrlStyle
[in] Dieser Parameter wird nicht verwendet.

dwStyle
[in] Eine logische Kombination von Formatvorlagen für das neue Fenster.

nID
[in] ID des neuen Fensters.

Rückgabewert

TRUE wenn das Fenster erstellt wurde; andernfalls FALSE.

Hinweise

CMFCRibbonBar::DeactivateKeyboardFocus

Schließt alle Zugriffstasteninfo-Steuerelemente auf der Menübandleiste.

void DeactivateKeyboardFocus(BOOL bSetFocus = TRUE);

Parameter

bSetFocus
[in] TRUE um den Fokus auf das übergeordnete Fenster der Menübandleiste festzulegen.

Hinweise

CMFCRibbonBar::DrawMenuImage

Zeichnet das Bild für eine Menüschaltfläche.

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

Parameter

pDC
[in] Zeigen Sie auf einen Gerätekontext für die Menüschaltfläche.

pMenuItem
[in] Zeigen Sie auf eine Symbolleistenmenüschaltfläche.

rectImage
[in] Das Anzeigerechteck für eine Menüschaltfläche.

Rückgabewert

TRUE wenn das Bild gezeichnet wurde; andernfalls FALSE.

Hinweise

CMFCRibbonBar::DWMCompositionChanged

Passt die Anzeige der Menübandleiste an, wenn die Komposition des Desktopfenster-Managers (DWM) aktiviert oder deaktiviert ist.

virtual void DWMCompositionChanged();

Hinweise

CMFCRibbonBar::EnableKeyTips

Aktiviert oder deaktiviert die Zugriffstasteninfo-Funktion für die Menübandleiste.

void EnableKeyTips(BOOL bEnable = TRUE);

Parameter

bEnable
[in] TRUE um das Feature "Zugriffstasteninfos" zu aktivieren; FALSE um das Feature "Zugriffstasteninfos" zu deaktivieren.

Hinweise

Wenn Sie dieses Feature aktivieren, werden Zugriffstasteninfos angezeigt, wenn der Benutzer die ALT - oder F10-Taste drückt. Wenn der Benutzer ALT drückt, werden Zugriffstasteninfos mit einer Verzögerung von 200 Millisekunden angezeigt. Diese Verzögerung ermöglicht die Ausführung von Tastenkombinationen, sodass die gedrückte ALT-Taste keine Anderen Kombinationen beeinträchtigt, die die ALT-TASTE enthalten.

CMFCRibbonBar::EnablePrintPreview

Aktiviert oder deaktiviert das Feature " Seitenansicht ".

void EnablePrintPreview(BOOL bEnable = TRUE);

Parameter

bEnable
[in] TRUE um das Feature "Seitenansicht" zu aktivieren; FALSE um das Feature "Seitenansicht" zu deaktivieren.

Hinweise

Wenn bEnable und eine Druckvorschaukategorie vorhanden ist FALSE , wird sie gelöscht.

Standardmäßig ist das Feature "Seitenansicht " aktiviert.

CMFCRibbonBar::EnableToolTips

Aktiviert oder deaktiviert QuickInfos und optionale QuickInfo-Beschreibungen auf der Menübandleiste.

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

Parameter

bEnable
[in] TRUE um QuickInfos auf der Menübandleiste zu aktivieren; FALSE um QuickInfos auf der Menübandleiste zu deaktivieren.

bEnableDescr
[in] TRUE um QuickInfo-Beschreibungen in der QuickInfo zu aktivieren; FALSE um QuickInfo-Beschreibungen in der QuickInfo zu deaktivieren.

Hinweise

Der bEnable Parameter bestimmt, ob QuickInfos angezeigt werden, wenn die Maus auf ein Menübandelement zeigt. Der bEnableDescr Parameter bestimmt, ob zusätzlicher beschreibender Text mit dem QuickInfo-Text angezeigt wird.

CMFCRibbonBar::FindByData

Ruft einen Zeiger auf ein Menübandelement ab, wenn er über die angegebenen Daten und die Sichtbarkeit verfügt.

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

Parameter

dwData
[in] Die daten, die einem Menübandelement zugeordnet sind.

bVisibleOnly
[in] TRUE nur sichtbare Menübandelemente zu durchsuchen; FALSE um alle Menübandelemente zu durchsuchen.

Rückgabewert

Ein Zeiger auf ein Menübandelement, wenn es über die angegebenen Daten und Sichtbarkeit verfügt; andernfalls NULL.

Hinweise

Ein Menübandelement ist ein beliebiges Steuerelement, das Sie dem Menüband hinzufügen können, z. B. eine Menübandschaltfläche oder eine Menübandkategorie oder ein Menübandschieberegler.

CMFCRibbonBar::FindByID

Ruft einen Zeiger auf das Menübandelement ab, das über die angegebene Befehls-ID und Suchwerte verfügt.

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

Parameter

uiCmdID
[in] Befehls-ID für ein Menübandelement.

bVisibleOnly
[in] TRUE nur sichtbare Menübandelemente zu durchsuchen; FALSE um alle Menübandelemente zu durchsuchen.

bExcludeQAT
[in] TRUE um Symbolleistenelemente für den Schnellzugriff von der Suche auszuschließen; andernfalls . FALSE

Rückgabewert

Ein Zeiger auf ein Menübandelement, wenn er über die angegebene Befehls-ID und Suchwerte verfügt; andernfalls . NULL

Hinweise

Ein Menübandelement ist ein beliebiges Menübandsteuerelement, das dem Menüband hinzugefügt werden kann, z. B. eine Menübandschaltfläche oder eine Menübandkategorie oder ein Menübandschieberegler.

Im Allgemeinen kann es mehrere Menübandelemente mit derselben Befehls-ID geben. Wenn Sie Zeiger auf alle Menübandelemente abrufen möchten, die eine angegebene Befehls-ID verwenden, verwenden Sie die CMFCRibbonBar::GetElementsByID Methode.

CMFCRibbonBar::FindCategoryIndexByData

Ruft den Index der Menübandkategorie ab, die die angegebenen Daten enthält.

int FindCategoryIndexByData(DWORD dwData) const;

Parameter

dwData
[in] Die Daten, die einer Menübandkategorie zugeordnet sind.

Rückgabewert

Der nullbasierte Index einer Menübandkategorie, wenn die Methode erfolgreich war; andernfalls -1.

CMFCRibbonBar::ForceRecalcLayout

Passt das Layout aller Elemente in der Menübandleiste und das übergeordnete Fenster an, und das gesamte Fenster wird neu gezeichnet.

void ForceRecalcLayout();

Hinweise

CMFCRibbonBar::GetActiveCategory

Ruft einen Zeiger auf die aktive Menübandkategorie ab.

CMFCRibbonCategory* GetActiveCategory() const;

Rückgabewert

Ein Zeiger auf die aktive Menübandkategorie; oder NULL wenn keine Kategorie aktiv ist.

Hinweise

Eine Kategorie ist aktiv, wenn sie den Fokus hat. Standardmäßig ist die aktive Kategorie die erste Kategorie auf der linken Seite der Menübandleiste.

Die Hauptkategorie wird angezeigt, wenn der Benutzer die Anwendungsschaltfläche drückt und nicht die aktive Kategorie sein kann.

CMFCRibbonBar::GetApplicationButton

Ruft einen Zeiger auf die Anwendungsschaltfläche ab.

CMFCRibbonApplicationButton* GetApplicationButton() const;

Rückgabewert

Ein Zeiger auf die Anwendungsschaltfläche; oder NULL wenn die Schaltfläche nicht festgelegt wurde.

CMFCRibbonBar::GetCaptionHeight

Ruft die Höhe des Beschriftungsbereichs für die Menübandleiste ab.

int GetCaptionHeight() const;

Rückgabewert

Die Höhe des Beschriftungsbereichs für die Menübandleiste in Pixel.

Hinweise

CMFCRibbonBar::GetCategory

Ruft einen Zeiger auf die Menübandkategorie am angegebenen Index ab.

CMFCRibbonCategory* GetCategory(int nIndex) const;

Parameter

nIndex
[in] Der nullbasierte Index einer Menübandkategorie in der Liste der Menübandkategorien, die in der Menübandleiste enthalten sind.

Rückgabewert

Ein Zeiger auf die Menübandkategorie am angegebenen Index; andernfalls, NULL wenn nIndex sie außerhalb des zulässigen Bereichs war.

CMFCRibbonBar::GetCategoryCount

Ruft die Anzahl der Menübandkategorien in der Menübandleiste ab.

int GetCategoryCount() const;

Rückgabewert

Die Anzahl der Menübandkategorien in der Menübandleiste.

CMFCRibbonBar::GetCategoryHeight

Ruft die Höhe der Kategorie ab.

int GetCategoryHeight() const;

Rückgabewert

Die Höhe der Kategorie.

Hinweise

Die Kategoriehöhe enthält die Höhe der Registerkarte "Kategorie".

CMFCRibbonBar::GetCategoryIndex

Ruft den Index der angegebenen Menübandkategorie ab.

int GetCategoryIndex(CMFCRibbonCategory* pCategory) const;

Parameter

pCategory
[in] Zeiger auf eine Menübandkategorie.

Rückgabewert

Der nullbasierte Index einer Menübandkategorie, die durch pCategory; oder -1 angegeben wird, wenn die Menübandkategorie nicht gefunden wird.

CMFCRibbonBar::GetContextName

Ruft den Namen der Kontextkategoriebeschriftung ab, die durch eine Kontext-ID angegeben wird.

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

Parameter

uiContextID
[in] Eine Kontext-ID der Menübandkategorie.

strName
[out] Der Name einer Kontextkategoriebeschriftung.

Rückgabewert

TRUE wenn die Methode erfolgreich war; andernfalls wurde die Beschriftung der Kontextkategorie nicht gefunden, FALSE wenn uiContextID null oder die Kontextkategoriebeschriftung nicht gefunden wurde.

CMFCRibbonBar::GetDroppedDown

Ruft das Menübandelement ab, das derzeit gelöscht wird.

virtual CMFCRibbonBaseElement* GetDroppedDown();

Rückgabewert

Das Menübandelement, das derzeit gelöscht wird; oder NULL wenn derzeit kein Menübandelement gelöscht wird.

Hinweise

CMFCRibbonBar::GetElementsByID

Ruft ein Array von Zeigern auf alle Menübandelemente ab, die über eine bestimmte Befehls-ID verfügen.

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

Parameter

uiCmdID
[in] Befehls-ID eines Menübandelements.

arButtons
[out] Ein Array von Zeigern auf Menübandelemente.

Hinweise

Mehrere Menübandelemente können dieselbe Befehls-ID aufweisen, da einige Menübandelemente auf die Symbolleiste für den Schnellzugriff kopiert werden können.

CMFCRibbonBar::GetHideFlags

Ruft die Flags ab, die angeben, wie viel der Menübandleiste sichtbar ist.

DWORD GetHideFlags() const;

Rückgabewert

Die Kennzeichnungen, die angeben, wie viel der Menübandleiste sichtbar ist.

Hinweise

In der folgenden Tabelle sind die möglichen Kombinationen von Flags für den Rückgabewert aufgeführt:

Flag Beschreibung
AFX_RIBBONBAR_HIDE_ELEMENTS Die Menübandleiste wird vertikal minimiert, und nur die Registerkarten der Kategorie, die Hauptschaltfläche und die Symbolleiste für den Schnellzugriff sind sichtbar.
AFX_RIBBONBAR_HIDE_ALL Die Breite der Menübandleiste ist kleiner als die Mindestbreite und ist vollständig ausgeblendet.

CMFCRibbonBar::GetItemIDsList

Ruft die Befehls-IDs für die angegebene Sammlung von Menübandelementen auf der Menübandleiste ab.

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

Parameter

lstItems
[out] Die Liste der Befehls-IDs für Menübandelemente, die in der Menübandleiste enthalten sind.

bHiddenOnly
[in] TRUE um menübandelemente auszuschließen, die angezeigt werden; FALSE um alle Menübandelemente in die Menübandleiste einzuschließen.

Hinweise

CMFCRibbonBar::GetKeyboardNavigationLevel

Ruft die aktuelle Navigationsebene ab, während der Benutzer die Zugriffstasteninfos drückt, die auf der Menübandleiste enthalten sind.

int GetKeyboardNavigationLevel() const;

Rückgabewert

Die aktuelle Navigationsebene, während der Benutzer die Zugriffstasteninfos drückt, die auf der Menübandleiste enthalten sind. In der folgenden Tabelle sind mögliche Rückgabewerte aufgeführt:

Wert Beschreibung
-1 Zugriffstasteninfos werden nicht angezeigt.
0 Zugriffstasteninfos werden angezeigt.
1 Der Benutzer hat eine angezeigte Zugriffstasteninfo gedrückt.

Hinweise

CMFCRibbonBar::GetKeyboardNavLevelCurrent

Ruft das aktuelle Tastaturnavigationsobjekt auf der Menübandleiste ab.

CObject* GetKeyboardNavLevelCurrent() const;

Rückgabewert

Das aktuelle Tastaturnavigationsobjekt auf der Menübandleiste; andernfalls NULL werden keine Zugriffstasteninfos angezeigt.

Hinweise

Das Objekt, das derzeit Zugriffstasteninfos anzeigt, ist das aktuelle Tastaturnavigationsobjekt.

CMFCRibbonBar::GetKeyboardNavLevelParent

Ruft das übergeordnete Tastaturnavigationsobjekt auf der Menübandleiste ab.

CObject* GetKeyboardNavLevelParent() const;

Rückgabewert

Das übergeordnete Tastaturnavigationsobjekt auf der Menübandleiste; andernfalls NULL.

Hinweise

Wenn der Benutzer eine Zugriffstasteninfo auf der Menübandleiste drückt, wird das aktuelle Tastaturnavigationsobjekt zum übergeordneten Tastaturnavigationsobjekt.

CMFCRibbonBar::GetMainCategory

Ruft einen Zeiger auf die Hauptmenübandkategorie ab.

CMFCRibbonCategory* GetMainCategory() const;

Rückgabewert

Ein Zeiger auf die Hauptmenübandkategorie.

Hinweise

Die Hauptmenübandkategorie enthält den Hauptmenübandbereich.

CMFCRibbonBar::GetQATCommandsLocation

Ruft das Anzeigerechteck für den Befehlsbereich der Symbolleiste für den Schnellzugriff ab.

CRect GetQATCommandsLocation() const;

Rückgabewert

Das Anzeigerechteck für den Befehlsbereich der Symbolleiste für den Schnellzugriff.

Hinweise

Der Befehlsabschnitt des Anzeigerechtecks enthält nicht die Schaltfläche zum Anpassen.

CMFCRibbonBar::GetQATDroppedDown

Ruft einen Zeiger auf das Menübandelement auf der Symbolleiste für den Schnellzugriff ab, in dem das Popupmenü nach unten verschoben wurde.

CMFCRibbonBaseElement* GetQATDroppedDown();

Rückgabewert

Ein Zeiger auf das Menübandelement auf der Symbolleiste für den Schnellzugriff, in dem das Popupmenü nach unten verschoben wurde.

Hinweise

CMFCRibbonBar::GetQuickAccessCommands

Ruft eine Liste der Befehls-IDs für die Menübandelemente auf der Symbolleiste für den Schnellzugriff ab.

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

Parameter

lstCommands
[out] Die Liste der Befehls-IDs für die Menübandelemente auf der Symbolleiste für den Schnellzugriff.

Hinweise

Die Liste enthält keine Menübandelemente, die Steuerelementtrennzeichen sind.

CMFCRibbonBar::GetQuickAccessToolbarLocation

Ruft das Anzeigerechteck für die Symbolleiste für den Schnellzugriff ab.

CRect GetQuickAccessToolbarLocation() const;

Rückgabewert

Das Anzeigerechteck für die Symbolleiste für den Schnellzugriff.

Hinweise

CMFCRibbonBar::GetTabTrancateRatio

Ruft die Prozentuale Größenreduzierung in der Anzeigebreite der Kategorieregisterkarten ab.

int GetTabTrancateRatio() const;

Rückgabewert

Die Verkleinerung der Prozentgröße in der Anzeigebreite der Kategorieregisterkarten.

Hinweise

Kategorieregisterkarten werden in der Breite reduziert, wenn nicht genügend Breite auf der Menübandleiste vorhanden ist.

CMFCRibbonBar::GetTooltipFixedWidthLargeImage

Ruft die große Größe der QuickInfo-Breite für die Menübandleiste ab.

int GetTooltipFixedWidthLargeImage() const;

Rückgabewert

Die große Größe der QuickInfo-Breite in Pixeln.

Hinweise

Wenn die große Größe der QuickInfo-Breite 0 ist, variiert die Breite.

CMFCRibbonBar::GetTooltipFixedWidthRegular

Ruft die normale Größe der QuickInfo-Breite für die Menübandleiste ab.

int GetTooltipFixedWidthRegular() const;

Rückgabewert

Die normale Größe der QuickInfo-Breite in Pixeln.

Hinweise

Wenn die normale Größe der QuickInfo-Breite 0 ist, variiert die Breite.

CMFCRibbonBar::GetVisibleCategoryCount

Ruft die Anzahl der sichtbaren Kategorien auf der Menübandleiste ab.

int GetVisibleCategoryCount() const;

Rückgabewert

Die Anzahl der sichtbaren Kategorien auf der Menübandleiste.

Hinweise

CMFCRibbonBar::HideAllContextCategories

Blendet alle Kontextkategorien auf der Menübandleiste aus.

BOOL HideAllContextCategories();

Rückgabewert

TRUEwenn mindestens eine Kontextkategorie ausgeblendet wurde; andernfalls . FALSE

Hinweise

Wenn eine Kontextkategorie aktiv ist, wird die aktive Kategorie auf die erste sichtbare Kategorie in der Kategorieliste zurückgesetzt.

CMFCRibbonBar::HideKeyTips

Blendet alle Zugriffstasteninfos auf der Menübandleiste aus.

void HideKeyTips();

Hinweise

CMFCRibbonBar::HitTest

Ruft einen Zeiger auf das Menübandelement ab, das durch die Position des Punkts angegeben wird.

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

Parameter

point
[in] Position des Punkts in Menübandleistenkoordinaten.

bCheckActiveCategory
[in] TRUE um die aktive Kategorie zu durchsuchen; FALSE die aktive Kategorie nicht zu durchsuchen.

bCheckPanelCaption
[in] TRUE um die Beschriftung des Menübandbereichs mit dem darin befindlichen Punkt zu testen; FALSE die Beschriftung des Menübandbereichs nicht mit dem darin befindlichen Punkt zu testen. Weitere Informationen finden Sie im Abschnitt Bemerkungen.

Rückgabewert

Ein Zeiger auf das Menübandelement, das sich am angegebenen Punkt befindet; andernfalls NULL , wenn sich der Punkt nicht in einem Menübandelement befindet.

Hinweise

Die Beschriftung des Menübandbereichs mit dem darin befindlichen Punkt wird nicht getestet, es sei denn, der bCheckActiveCategory Parameter ist TRUE.

CMFCRibbonBar::IsKeyTipEnabled

Gibt an, ob das Feature für Zugriffstasteninfos aktiviert ist.

BOOL IsKeyTipEnabled() const;

Rückgabewert

TRUE wenn das Feature "Zugriffstasteninfos" aktiviert ist; andernfalls FALSE.

CMFCRibbonBar::IsMainRibbonBar

Gibt an, ob die Menübandleiste die primäre Menübandleiste ist.

virtual BOOL IsMainRibbonBar() const;

Rückgabewert

Gibt immer TRUE zurück.

Hinweise

Standardmäßig gibt diese Methode immer zurück TRUE. Überschreiben Sie diese Methode, um anzugeben, ob die Menübandleiste die primäre Menübandleiste ist.

CMFCRibbonBar::IsPrintPreviewEnabled

Gibt an, ob das Feature "Seitenansicht " aktiviert ist.

BOOL IsPrintPreviewEnabled() const;

Rückgabewert

TRUE wenn das Feature "Seitenansicht " aktiviert ist; andernfalls FALSE.

CMFCRibbonBar::IsQATEmpty

Gibt an, ob die Symbolleiste für den Schnellzugriff Befehlsschaltflächen enthält.

BOOL IsQATEmpty() const;

Rückgabewert

TRUE wenn die Symbolleiste für den Schnellzugriff Befehlsschaltflächen enthält; andernfalls FALSE.

Hinweise

CMFCRibbonBar::IsQuickAccessToolbarOnTop

Gibt an, ob sich die Symbolleiste für den Schnellzugriff über oder unter der Menübandleiste befindet.

BOOL IsQuickAccessToolbarOnTop() const;

Rückgabewert

TRUE wenn sich die Symbolleiste für den Schnellzugriff über der Menübandleiste befindet; FALSE wenn sich die Symbolleiste für den Schnellzugriff unter der Menübandleiste befindet.

CMFCRibbonBar::IsReplaceFrameCaption

Gibt an, ob die Menübandleiste unter der Beschriftung des Hauptrahmenfensters steht oder nicht.

BOOL IsReplaceFrameCaption() const;

Rückgabewert

TRUE wenn die Menübandleiste die Beschriftung des Hauptrahmenfensters ersetzt; FALSE wenn sich die Menübandleiste unter der Beschriftung des Hauptrahmenfensters befindet.

CMFCRibbonBar::IsShowGroupBorder

Gibt an, ob Schaltflächengruppen auf der Menübandleiste einen Gruppenrahmen anzeigen.

virtual BOOL IsShowGroupBorder(CMFCRibbonButtonsGroup* pGroup) const;

Parameter

pGroup
[in] Dieser Parameter wird nicht verwendet.

Rückgabewert

Gibt immer FALSE zurück.

Hinweise

Standardmäßig gibt diese Methode immer zurück FALSE. Überschreiben Sie diese Methode, um anzugeben, ob Schaltflächengruppen auf der Menübandleiste einen Gruppenrahmen anzeigen.

CMFCRibbonBar::IsToolTipDescrEnabled

Gibt an, ob QuickInfo-Beschreibungen aktiviert sind.

BOOL IsToolTipDescrEnabled() const;

Rückgabewert

TRUE wenn QuickInfo-Beschreibungen aktiviert sind; FALSE wenn QuickInfo-Beschreibungen deaktiviert sind.

Hinweise

QuickInfo-Beschreibungen sind zusätzlicher beschreibender Text, der mit dem QuickInfo-Text angezeigt wird.

CMFCRibbonBar::IsToolTipEnabled

Gibt an, ob QuickInfos für die Menübandleiste aktiviert oder deaktiviert sind.

BOOL IsToolTipEnabled() const;

Rückgabewert

TRUE wenn QuickInfos aktiviert sind; FALSE wenn QuickInfos deaktiviert sind.

CMFCRibbonBar::IsTransparentCaption

Gibt an, ob die Anzeige für das Windows Aero-Farbschema festgelegt ist.

BOOL IsTransparentCaption() const;

Rückgabewert

TRUE wenn das Farbschema Windows Aero ist; andernfalls FALSE.

Hinweise

CMFCRibbonBar::OnClickButton

Diese Methode wird zur Abwärtskompatibilität mit vorhandenen Anwendungen beibehalten und sollte nicht für die neue Entwicklung verwendet werden.

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

Parameter

pButton
[in] Zeigen Sie auf die Schaltfläche, auf die geklickt wurde.

point
[in] Dieser Parameter wird nicht verwendet.

Hinweise

CMFCRibbonBar::OnEditContextMenu

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

Parameter

[in] pEdit
[in] point\

Hinweise

CMFCRibbonBar::OnRTLChanged

Wird vom Framework aufgerufen, wenn das Layout die Richtung ändert.

virtual void OnRTLChanged(BOOL bIsRTL);

Parameter

bIsRTL
[in] TRUE wenn das Layout von rechts nach links ist; FALSE wenn das Layout von links nach rechts ist.

Hinweise

Mit dieser Methode wird das Layout aller Steuerelemente auf der Menübandleiste für die neue Layoutrichtung angepasst.

CMFCRibbonBar::OnSetAccData

Diese Methode ist intern für das Framework und ist nicht für den Aufruf aus Benutzercode vorgesehen.

BOOL OnSetAccData(long lVal);

Parameter

long lVal Der Index des barrierefreien Objekts.

Rückgabewert

S_OK wenn erfolgreich; andernfalls FALSE oder S_FALSE.

Hinweise

CMFCRibbonBar::OnShowRibbonContextMenu

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

Parameter

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

Rückgabewert

Bemerkungen

CMFCRibbonBar::OnShowRibbonQATMenu

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

Parameter

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

Rückgabewert

Bemerkungen

CMFCRibbonBar::OnSysKeyDown

Wird vom Framework aufgerufen, wenn der Benutzer die F10-TASTE drückt oder die ALT-TASTE gedrückt hält und dann eine andere Taste drückt.

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

Parameter

pFrameWnd
[in] Zeigen Sie auf das übergeordnete Hauptrahmenfenster der Menübandleiste.

wParam
[in] Virtueller Tastencode der taste, die gedrückt wird.

lParam
[in] Tastaturstatuskennzeichnungen, wenn die Taste gedrückt wurde.

Rückgabewert

TRUE wenn das Tastenanschlagereignis verarbeitet wurde; andernfalls FALSE.

Hinweise

CMFCRibbonBar::OnSysKeyUp

Wird vom Framework aufgerufen, wenn der Benutzer die F10-Taste , die ALT-TASTE oder eine Taste freigibt, die gedrückt wurde, als die ALT-Taste gedrückt wurde.

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

Parameter

pFrameWnd
[in] Zeigen Sie auf das übergeordnete Hauptrahmenfenster der Menübandleiste.

wParam
[in] Virtueller Schlüsselcode des losgelassenen Schlüssels.

lParam
[in] Dieser Parameter wird nicht verwendet.

Rückgabewert

TRUE wenn das Tastenanschlagereignis verarbeitet wurde; andernfalls FALSE.

Hinweise

CMFCRibbonBar::PopTooltip

Entfernt eine QuickInfo aus der Ansicht.

void PopTooltip();

Hinweise

CMFCRibbonBar::PreTranslateMessage

Bestimmt, ob die angegebene Nachricht von der Menübandleiste verarbeitet wird.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parameter

pMsg
[in] Zeiger auf eine Nachricht.

Rückgabewert

TRUE wenn die Nachricht von der Menübandleiste verarbeitet wurde; andernfalls FALSE.

Hinweise

CMFCRibbonBar::RecalcLayout

Passt das Layout aller Steuerelemente auf der Menübandleiste an.

virtual void RecalcLayout();

Hinweise

Nach der Layoutanpassung wird die Anzeige der Menübandleiste aktualisiert.

CMFCRibbonBar::RemoveAllCategories

Löscht alle Menübandkategorien aus der Menübandleiste.

void RemoveAllCategories();

Hinweise

Mit dieser Methode werden alle Menübandkategorien aus dem Arbeitsspeicher und aus der Kategorieliste gelöscht.

CMFCRibbonBar::RemoveAllFromTabs

Entfernt alle Menübandelemente aus dem Registerkartenbereich.

void RemoveAllFromTabs();

Hinweise

Verwenden Sie diese Funktion, wenn Sie alle Elemente entfernen möchten, die Sie mithilfe der CMFCRibbonBar::AddToTabs Methode zum Registerkartenbereich hinzugefügt haben.

CMFCRibbonBar::RemoveCategory

Löscht die angegebene Menübandkategorie aus der Menübandleiste.

BOOL RemoveCategory(int nIndex);

Parameter

nIndex
[in] Der nullbasierte Index einer Kategorie in der Liste der Menübandkategorien, die in der Menübandleiste enthalten sind.

Rückgabewert

TRUE wenn die angegebene Menübandkategorie gelöscht wurde; andernfalls FALSE.

Hinweise

Die angegebene Menübandkategorie wird aus dem Arbeitsspeicher und aus der Kategorieliste gelöscht.

CMFCRibbonBar::SetActiveCategory

Legt die angegebene Menübandkategorie als aktive Kategorie fest.

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

Parameter

pCategory
[in] Eine Menübandkategorie, die in der Menübandleiste enthalten ist.

bForceRestore
[in] TRUE um die Menübandleiste zu maximieren, wenn sie minimiert ist; FALSE um die aktive Kategorie in einem Popupfenster anzuzeigen, wenn die Menübandleiste minimiert ist.

Rückgabewert

TRUE wenn die angegebene Kategorie als aktive Kategorie festgelegt wurde; andernfalls FALSE.

Hinweise

Die Hauptmenübandkategorie kann nicht die aktive Kategorie sein.

Wenn die durch pCategory die angegebene Kategorie nicht angezeigt wird, kann sie nicht als aktive Kategorie festgelegt werden.

CMFCRibbonBar::SetActiveMDIChild

Ordnet die Systemschaltflächen auf der Menübandleiste zu einem untergeordneten MDI-Fenster (Multiple-Document Interface, MDI) dem angegebenen untergeordneten MDI-Fenster zu.

void SetActiveMDIChild(CWnd* pWnd);

Parameter

pWnd
[in] Zeigen Sie auf ein untergeordnetes MDI-Fenster.

Hinweise

CMFCRibbonBar::SetApplicationButton

Weist der Menübandleiste eine Anwendungsschaltfläche zu.

void SetApplicationButton(
    CMFCRibbonApplicationButton* pButton,
    CSize sizeButton);

Parameter

pButton
[in] Ein Zeiger auf die Schaltfläche des Anwendungsmenübands.

sizeButton
[in] Die Größe der Menübandschaltfläche der Anwendung.

Hinweise

Die Schaltfläche des Menübands der Anwendung ist eine große abgerundete Schaltfläche in der oberen linken Ecke des Menüband-Steuerelements.

Beispiel

Im folgenden Beispiel wird die Verwendung der SetApplicationButton Methode in der CMFCRibbonBar Klasse veranschaulicht.

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

Legt die Zugriffstasteninfos für alle Menübandelemente fest, die über die angegebene Befehls-ID verfügen.

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

Parameter

uiCmdID
[in] Die Befehls-ID eines Menübandelements.

lpszKeys
[in] Die Zugriffstaste.

lpszMenuKeys
[in] Die Zugriffstasteninfo des Menüs.

Rückgabewert

TRUE wenn die Zugriffstasteninfos von mindestens einem Menübandelement festgelegt sind; andernfalls FALSE.

Hinweise

Die optionale Menütasteninfo ist für Menübandelemente mit einer geteilten Schaltfläche vorgesehen, mit der ein Popupmenü geöffnet wird.

CMFCRibbonBar::SetKeyboardNavigationLevel

Legt die Tastaturnavigationsebene fest, während der Benutzer die Zugriffstasteninfos drückt, die auf der Menübandleiste enthalten sind.

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

Parameter

pLevel
[in] Zeiger auf das aktuelle Tastaturnavigationsobjekt.

bSetFocus
[in] TRUE um den Tastaturfokus auf die Menübandleiste festzulegen.

Hinweise

Die Tastaturnavigation der Menübandleiste wird gestartet, wenn der Benutzer die ALT - oder F10-TASTE drückt. Der Benutzer wählt die nächste Navigationsebene aus, indem er auf der Menübandleiste eine Zugriffstasteninfo drückt. Der Benutzer kann zur vorherigen Navigationsebene zurückkehren, indem er die ESCAPE-TASTE drückt.

CMFCRibbonBar::SetMaximizeMode

Passt die Menübandleiste an, wenn die Fenstergröße eines untergeordneten MDI-Fensters (Multiple-Document Interface) in den maximierten Zustand wechselt oder verlässt.

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

Parameter

bMax
[in] TRUE um die Systemschaltflächen für ein untergeordnetes MDI-Fenster auf der Menübandleiste anzuzeigen; FALSE um die Systemschaltflächen für ein untergeordnetes MDI-Fenster aus der Menübandleiste zu entfernen.

pWnd
[in] Zeigen Sie auf das Hauptrahmenfenster für die Menübandleiste.

Hinweise

Auf der Menübandleiste werden Systemschaltflächen für ein untergeordnetes MDI-Fenster in der Registerkartenzeile angezeigt, wenn ein untergeordnetes MDI-Fenster maximiert wird.

CMFCRibbonBar::SetQuickAccessCommands

Fügt der Symbolleiste für den Schnellzugriff eines oder mehrere Menübandelemente hinzu.

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

Parameter

lstCommands
[in] Die Liste der Befehle, die auf der Symbolleiste für den Schnellzugriff platziert werden sollen.

bRecalcLayout
[in] TRUE wenn Sie das Menüband neu zeichnen möchten, nachdem Sie die Menübandelemente hinzugefügt haben. FALSE sonst.

Beispiel

Im folgenden Beispiel wird die Verwendung der SetQuickAccessCommands Methode in der CMFCRibbonBar Klasse veranschaulicht.

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

Legt die Symbolleiste für den Schnellzugriff auf den Standardzustand fest.

void SetQuickAccessDefaultState(const CMFCRibbonQuickAccessToolBarDefaultState& state);

Parameter

state
[in] Der Standardstatus der Symbolleiste für den Schnellzugriff.

Hinweise

Der Symbolleistenstatus für den Schnellzugriff enthält eine Liste von Befehlen und deren Sichtbarkeit.

Beispiel

Im folgenden Beispiel wird die Verwendung der SetQuickAccessDefaultState Methode in der CMFCRibbonBar Klasse veranschaulicht.

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

Positioniert die Symbolleiste für den Schnellzugriff über oder unterhalb der Menübandleiste.

void SetQuickAccessToolbarOnTop(BOOL bOnTop);

Parameter

bOnTop
[in] TRUE um die Symbolleiste für den Schnellzugriff über der Menübandleiste zu positionieren; FALSE um die Symbolleiste für den Schnellzugriff unterhalb der Menübandleiste zu positionieren.

CMFCRibbonBar::SetTooltipFixedWidth

Legt die regulären und großen Größen fester QuickInfo-Breite für die Menübandleiste fest.

void SetTooltipFixedWidth(
    int nWidthRegular,
    int nWidthLargeImage);

Parameter

nWidthRegular
[in] Die Breite in Pixeln einer regulären QuickInfo mit fester Größe.

nWidthLargeImage
[in] Die Breite in Pixeln einer großen QuickInfo mit fester Größe.

Hinweise

Das Festlegen eines Parameters auf 0 bewirkt, dass die entsprechende Breite variiert.

CMFCRibbonBar::ShowCategory

Blendet die angegebene Menübandkategorie ein oder aus.

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

Parameter

nIndex
[in] Der Index der Menübandkategorie.

bShow
[in] Wenn TRUE, zeigen Sie die Menübandkategorie an. Andernfalls blenden Sie die Menübandkategorie aus.

CMFCRibbonBar::ShowContextCategories

Blendet die Kontextkategorien mit der angegebenen ID ein oder aus.

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

Parameter

uiContextID
[in] Die Kontextkategorie-ID.

bShow
[in] Wenn TRUE, zeigen Sie die Kategorien mit der angegebenen ID an. Andernfalls blenden Sie die Kategorien aus, die die angegebene ID aufweisen.

CMFCRibbonBar::ShowKeyTips

Zeigt die Zugriffstasteninfos für jedes Menübandelement auf der Menübandleiste an.

void ShowKeyTips();

Hinweise

CMFCRibbonBar::ToggleMimimizeState

Schaltet die Menübandleiste zwischen den minimierten und maximierten Zustand um.

void ToggleMimimizeState();

Hinweise

Tippfehler im Methodennamen sind ein bekanntes Problem.

Im minimierten Zustand wird das Menüband ausgeblendet, und nur die Registerkarten werden angezeigt. Wenn der Benutzer auf eine Registerkarte klickt, wird die Menübandsteuerung als ein Popupfenster angezeigt. Das Fenster wird geschlossen, wenn der Benutzer daneben klickt oder ein Befehl ausgeführt wird.

CMFCRibbonBar::TranslateChar

Bestimmt, ob der angegebene Tastenanschlagzeichencode von der Menübandleiste verarbeitet wird.

virtual BOOL TranslateChar(UINT nChar);

Parameter

nChar
[in] Ein Benutzertastenzeichencode.

Rückgabewert

TRUE wenn der Zeichencode von der Menübandleiste verarbeitet wurde; andernfalls FALSE.

Hinweise

Mit dem Feature "Zugriffstasteninfos" können Benutzer über die Tastatur in der Menübandleiste navigieren.

CMFCRibbonBar::GetFocused

Gibt ein Fokuselement zurück.

virtual CMFCRibbonBaseElement* GetFocused();

Rückgabewert

Ein Zeiger auf ein fokussiertes Element oder NULL.

Hinweise

CMFCRibbonBar::IsWindows7Look

Gibt an, ob das Menüband ein Windows 7-Aussehen aufweist (kleine rechteckige Anwendungsschaltfläche).

BOOL IsWindows7Look() const;

Rückgabewert

TRUE wenn das Menüband ein Windows 7-Aussehen aufweist; andernfalls FALSE.

Hinweise

CMFCRibbonBar::LoadFromResource

Überladen. Lädt eine Menübandleiste aus den Anwendungsressourcen.

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

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

Parameter

uiXMLResID
Gibt die Ressourcen-ID der XML-Zeichenfolge mit Informationen zur Menübandleiste an.

lpszResType
Gibt den Typ der Ressource an, die sich befindet uiXMLResID.

hInstance
Behandeln Sie das Modul, dessen ausführbare Datei die Ressource enthält. Wenn hInstance ja NULL, lädt das System die Ressource aus dem Modul, das zum Erstellen des aktuellen Prozesses verwendet wurde.

lpszXMLResID
Gibt die Ressourcen-ID (in Zeichenfolgenform) mit Informationen der Menübandleiste an.

Rückgabewert

TRUE wenn die Last erfolgreich ist; andernfalls FALSE.

Hinweise

CMFCRibbonBar::SaveToXMLBuffer

Speichert die Menübandleiste in einem Puffer.

UINT SaveToXMLBuffer(LPBYTE* ppBuffer) const;

Parameter

ppBuffer
Wenn diese Funktion zurückgegeben wird, verweist sie auf einen puffer, ppBuffer der dieser Methode zugeordnet ist, und enthält Informationen zur Menübandleiste im XML-Format.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

CMFCRibbonBar::SaveToXMLFile

Speichert die Menübandleiste in einer XML-Datei.

BOOL SaveToXMLFile(LPCTSTR lpszFilePath) const;

Parameter

lpszFilePath
Gibt die Ausgabedatei an.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

CMFCRibbonBar::SetWindows7Look

Aktiviert oder deaktiviert ein Windows 7-Aussehen (kleine rechteckige Anwendungsschaltfläche) für das Menüband.

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

Parameter

bWindows7Look
TRUE legt ein Windows 7-Aussehen fest; FALSE sonst.

bRecalc
TRUE berechnet das Menübandlayout neu; FALSE sonst.

Hinweise

Weitere Informationen

Hierarchiediagramm
Klassen
CPane Klasse
CMFCRibbonCategory Klasse
CMFCRibbonPanel Klasse
CMFCRibbonBaseElement Klasse
Exemplarische Vorgehensweise: Aktualisieren der MFC Scribble-Anwendung