Detailed Description

The CBCGPRibbonCategory class implements the functionality of a logical entity containing a group of panels. The visual representation of Ribbon Category is a Ribbon Tab (CBCGPRibbonTab, which in its turn derived from CBCGPBaseRibbonElement).

Ususally you create Ribbon Categories indirectly using CBCGPRibbonBar::AddCategory, which returns a pointer to the newly created category. After that you can set up the category by adding new panels (CBCGPRibbonCategory::AddPanel).

Example:

Copy

CBCGPRibbonCategory* pCategory = m_wndRibbonBar.AddCategory(
    _T("&Write"),       // Category name    
    IDB_WRITE,          // Category small images (16 x 16)
    IDB_WRITE_LARGE);   // Category large images (32 x 32)
CBCGPRibbonPanel* pPanel = pCategory->AddPanel(
    _T("Clipboard"),    // Panel name
    m_PanelIcons.ExtractIcon(0));  // Panel icon

Public Member Functions
	AddHidden	Adds a hidden element to category.

	AddPanel	Adds a new panel to category.

	AddPanel	Adds a new panel to category.

	EnableScroll	Enables or disables the Ribbon category scrolling.

	GetApplicationModes	Gets application modes where this category (tab) is visible.

	GetContextID	Returns context ID of category.

	GetData	Returns user-defined data associated with category.

	GetLargeImages	Returns a reference to list of category large images.

	GetMediumImages	Returns a reference to list of category medium (used in simplified mode) images.

	GetPanel	Returns a panel located at the specified index in the list of panels.

	GetPanelCount	Returns the number of panels in category.

	GetPanelIndex	Given a pointer to a ribbon panel returns its index.

	GetSmallImages	Returns a reference to list of category small images.

	GetTabColor	Returns the current tab color.

	IsScrollEnabled	Tells whether the Ribbon category scrolling is enabled.

	IsVisible	Tells whether category is visible, or not.

	RemovePanel	Removes a panel from a Ribbon Category.

	SetApplicationModes	Sets application modes where this category (tab) is visible.

	SetCollapseOrder	Defines the collapse order of category.

	SetData	Associates user-defined-data with category.

	SetKeys	Assigns a key tip for category.

	SetTabColor	Sets ribbon tab color (usually used for context tabs).

Protected Member Functions
	CBCGPRibbonCategory	Constructs a category object.

	CBCGPRibbonCategory	Constructs a category object.

Detailed Description

Public Member Functions

Protected Member Functions