`CMFCRibbonBar`-Klasse

Artikel
10/12/2023

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

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

Freigeben über

CMFCRibbonBar-Klasse

Syntax

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Hinweise

Vererbungshierarchie

Anforderungen

CMFCRibbonBar::ActivateContextCategory

Parameter

Rückgabewert

CMFCRibbonBar::AddCategory

Parameter

Rückgabewert

Hinweise

Beispiel

CMFCRibbonBar::AddContextCategory

Parameter

Rückgabewert

Hinweise

CMFCRibbonBar::AddMainCategory

Parameter

Rückgabewert

Hinweise

Beispiel

CMFCRibbonBar::AddPrintPreviewCategory

Rückgabewert

Hinweise

CMFCRibbonBar::AddQATOnlyCategory

Parameter

Rückgabewert

Hinweise

CMFCRibbonBar::AddToTabs

Parameter

Hinweise

CMFCRibbonBar::CMFCRibbonBar

Parameter

Hinweise

CMFCRibbonBar::Create

Parameter

Rückgabewert

Hinweise

Beispiel

CMFCRibbonBar::CreateEx

Parameter

Rückgabewert

Hinweise

CMFCRibbonBar::DeactivateKeyboardFocus

Parameter

Hinweise

CMFCRibbonBar::DrawMenuImage

Parameter

Rückgabewert

Hinweise

CMFCRibbonBar::DWMCompositionChanged

Hinweise

CMFCRibbonBar::EnableKeyTips

Parameter

Hinweise

CMFCRibbonBar::EnablePrintPreview

Parameter

Hinweise

CMFCRibbonBar::EnableToolTips

Parameter

Hinweise

CMFCRibbonBar::FindByData

Parameter

Rückgabewert

Hinweise

CMFCRibbonBar::FindByID

Parameter

Rückgabewert

Hinweise

CMFCRibbonBar::FindCategoryIndexByData

Parameter

Rückgabewert

CMFCRibbonBar::ForceRecalcLayout

Hinweise

CMFCRibbonBar::GetActiveCategory

`CMFCRibbonBar`-Klasse

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