Home Library Learn Samples Downloads Support Community Forums
MSDN Library
Development Tools and Languages
Visual Studio 2008
Visual Studio
Visual C++
Reference
Libraries Reference
MFC Feature Pack for Visual C++ 2008
Reference
Classes
CMFCRibbonCategory Class
CMFCRibbonCategory::AddHidden
CMFCRibbonCategory::AddPanel
CMFCRibbonCategory::CopyFrom
CMFCRibbonCategory::CMFCRibbonCategory
CMFCRibbonCategory::FindByData
CMFCRibbonCategory::FindByID
CMFCRibbonCategory::FindPanelWithElem
CMFCRibbonCategory::GetContextID
CMFCRibbonCategory::GetData
CMFCRibbonCategory::GetDroppedDown
CMFCRibbonCategory::GetElements
CMFCRibbonCategory::GetElementsByID
CMFCRibbonCategory::GetImageCount
CMFCRibbonCategory::GetImageSize
CMFCRibbonCategory::GetItemIDsList
CMFCRibbonCategory::GetLargeImages
CMFCRibbonCategory::GetMaxHeight
CMFCRibbonCategory::GetName
CMFCRibbonCategory::GetPanel
CMFCRibbonCategory::GetPanelCount
CMFCRibbonCategory::GetPanelFromPoint
CMFCRibbonCategory::GetPanelIndex
CMFCRibbonCategory::GetParentButton
CMFCRibbonCategory::GetParentMenuBar
CMFCRibbonCategory::GetParentRibbonBar
CMFCRibbonCategory::GetRect
CMFCRibbonCategory::GetSmallImages
CMFCRibbonCategory::GetTabColor
CMFCRibbonCategory::GetTabRect
CMFCRibbonCategory::GetTextTopLine
CMFCRibbonCategory::HighlightPanel
CMFCRibbonCategory::HitTest
CMFCRibbonCategory::HitTestEx
CMFCRibbonCategory::HitTestScrollButtons
CMFCRibbonCategory::IsActive
CMFCRibbonCategory::IsVisible
CMFCRibbonCategory::NotifyControlCommand
CMFCRibbonCategory::OnCancelMode
CMFCRibbonCategory::OnDraw
CMFCRibbonCategory::OnDrawImage
CMFCRibbonCategory::OnDrawMenuBorder
CMFCRibbonCategory::OnLButtonDown
CMFCRibbonCategory::OnLButtonUp
CMFCRibbonCategory::OnMouseMove
CMFCRibbonCategory::OnRTLChanged
CMFCRibbonCategory::OnScrollHorz
CMFCRibbonCategory::OnUpdateCmdUI
CMFCRibbonCategory::RecalcLayout
CMFCRibbonCategory::RemovePanel
CMFCRibbonCategory::ReposPanels
CMFCRibbonCategory::SetCollapseOrder
CMFCRibbonCategory::SetData
CMFCRibbonCategory::SetKeys
CMFCRibbonCategory::SetName
CMFCRibbonCategory::SetTabColor
Expand Minimize
This topic has not yet been rated - Rate this topic

CMFCRibbonCategory::AddPanel

Visual Studio 2008

Updated: October 2008

Creates a ribbon panel for the ribbon category.

Copy 
CMFCRibbonPanel* AddPanel(
   LPCTSTR lpszPanelName,
   HICON hIcon = 0,
   CRuntimeClass* pRTI = NULL 
);
[in] lpszPanelName

Pointer to the name of the new ribbon panel.

[in] hIcon

Handle to the default icon for the new ribbon panel.

[in] pRTI

Pointer to runtime class information for a custom ribbon panel.

Pointer to the new ribbon panel if the method was successful; otherwise NULL if the panel was not created.

If you want to create a custom ribbon panel, you must specify its runtime class information in pRTI. The custom ribbon panel class must be derived from the CMFCRibbonPanel class.

The default icon for the ribbon panel is displayed when there is insufficient space to display the ribbon elements.

The following example demonstrates how to use the AddPanel method in the CMFCRibbonCategory class.

C++
Copy 
	// Create "Favorites" panel:
	strTemp.LoadString(IDS_RIBBON_FAVORITES);
	// CMFCRibbonCategory* pCategoryCustom
	CMFCRibbonPanel* pPanelFavorites = pCategoryCustom->AddPanel(strTemp, 
		m_PanelImages.ExtractIcon(15));

Header: afxribboncategory.h

Date

History

Reason

October 2008

Updated whole topic.

Information enhancement.

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.