|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer|
The CMFCRibbonBar class implements a ribbon bar similar to that used in Office 2007.
Activates a context category that is already visible.
Adds a new ribbon category to the ribbon.
Adds a context category.
Adds a new main ribbon category.
Add a ribbon element to the right side of a ribbon bar.
Creates a ribbon bar control and attaches it to a ribbon bar.
Enable or disable key tips for the ribbon control.
Enable the Print Preview tab.
Enables or disables tooltips and tooltip descriptions on the ribbon bar.
Find a ribbon element by using data that a user specifies.
Finds a ribbon element that has the specified command id.
Finds the index of the ribbon category that contains the user-defined data.
Gets a pointer to an active category.
Returns the caption height. (Overrides CBasePane::GetCaptionHeight.)
Gets the pointer to a category located at a specified index.
Gets the number of the ribbon categories in the ribbon bar.
Returns the index of a ribbon category.
Retrieves the name of the context category caption that you specify by using an ID.
Gets an array that contains the pointers to all the ribbon elements that have the specified ID.
Gets a pointer to a ribbon button.
Returns a pointer to the ribbon category that is currently selected.
Fills a list that contains the command IDs of all the elements that appear on the Quick Access Toolbar.
Hides all the categories that are active and visible.
Finds a pointer to the ribbon element that is located at the specified point in the ribbon bar's client coordinates.
Determines whether keytips are enabled.
Determines whether the Print Preview tab is enabled.
Specifies whether the Quick Access Toolbar is located above the ribbon bar.
Determines whether the ribbon bar replaces the main frame caption, or is added below the frame caption.
Determines whether the tooltip descriptions are enabled.
Determines whether the tooltips for the ribbon bar are enabled.
Removes all the ribbon categories from the ribbon bar.
Removes all ribbon elements from the tab area.
Removes the ribbon category that is located at the specified index.
Sets a specified ribbon category to active.
Sets the specified keytips for all ribbon elements that have the specified command ID.
Assigns an application ribbon button to the ribbon bar.
Adds one or more ribbon elements to the Quick Access Toolbar.
Specifies the default state for the Quick Access Toolbar.
Positions the Quick Access Toolbar (QAT) above or below the ribbon bar.
Shows or hides the specified ribbon category.
Shows or hides the context categories that have the specified ID.
Toggles the ribbon bar between the minimized and maximized states..
Microsoft introduced the Office Fluent Ribbon when it simultaneously released Microsoft Office 2007. This ribbon bar is not just a new control. It represents a new user-interface paradigm. The ribbon is a pane that contains a set of tabs called categories. Each category is logically split into ribbon panels and each panel can contain various controls and command buttons.
The elements that appear on the ribbon bar expand and contract to make the best use of available space. For example, if a ribbon panel has insufficient space to display its elements, it becomes a menu button that displays subitems on a pop-up menu. The ribbon bar behaves as a static (non-floating) control bar and can be docked at the top of a frame.
You can use the CMFCRibbonStatusBar class to implement a status bar similar to the one used in Office 2007. A ribbon category contains (and displays) a group of ribbon panels. Each ribbon panel contains one or more ribbon elements, which are derived from CMFCRibbonBaseElement.
For information about how to add a ribbon bar to your existing MFC application, see Walkthrough: Updating the MFC Scribble Application.