Home Library Learn Samples Downloads Support Community Forums
MSDN Library
Development Tools and Languages
Visual Studio 2010
Visual Studio
Visual Studio Languages
Visual C++
Visual C++ Reference
Visual C++ Libraries Reference
MFC
MFC Classes
CMFCRibbonBar Class
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
CMFCRibbonBar::HideAllContextCategories
CMFCRibbonBar::HideKeyTips
CMFCRibbonBar::HitTest
CMFCRibbonBar::IsKeyTipEnabled
CMFCRibbonBar::IsMainRibbonBar
CMFCRibbonBar::IsPrintPreviewEnabled
CMFCRibbonBar::IsQATEmpty
CMFCRibbonBar::IsQuickAccessToolbarOnTop
CMFCRibbonBar::IsReplaceFrameCaption
CMFCRibbonBar::IsShowGroupBorder
CMFCRibbonBar::IsToolTipDescrEnabled
CMFCRibbonBar::IsToolTipEnabled
CMFCRibbonBar::IsTransparentCaption
CMFCRibbonBar::OnClickButton
CMFCRibbonBar::OnEditContextMenu
CMFCRibbonBar::OnRTLChanged
CMFCRibbonBar::OnSetAccData
CMFCRibbonBar::OnShowRibbonContextMenu
CMFCRibbonBar::OnShowRibbonQATMenu
CMFCRibbonBar::OnSysKeyDown
CMFCRibbonBar::OnSysKeyUp
CMFCRibbonBar::PopTooltip
CMFCRibbonBar::PreTranslateMessage
CMFCRibbonBar::RecalcLayout
CMFCRibbonBar::RemoveAllCategories
CMFCRibbonBar::RemoveAllFromTabs
CMFCRibbonBar::RemoveCategory
CMFCRibbonBar::SetActiveCategory
CMFCRibbonBar::SetActiveMDIChild
CMFCRibbonBar::SetApplicationButton
CMFCRibbonBar::SetElementKeys
CMFCRibbonBar::SetKeyboardNavigationLevel
CMFCRibbonBar::SetMaximizeMode
CMFCRibbonBar::SetQuickAccessCommands
CMFCRibbonBar::SetQuickAccessDefaultState
CMFCRibbonBar::SetQuickAccessToolbarOnTop
CMFCRibbonBar::SetTooltipFixedWidth
CMFCRibbonBar::ShowCategory
CMFCRibbonBar::ShowContextCategories
CMFCRibbonBar::ShowKeyTips
CMFCRibbonBar::ToggleMimimizeState
CMFCRibbonBar::TranslateChar
CMFCRibbonBar::GetFocused
CMFCRibbonBar::IsWindows7Look
CMFCRibbonBar::LoadFromResource
CMFCRibbonBar::SaveToXMLBuffer
CMFCRibbonBar::SaveToXMLFile
CMFCRibbonBar::SetWindows7Look
Expand Minimize
This topic has not yet been rated - Rate this topic

CMFCRibbonBar::AddCategory

Visual Studio 2010

Creates and initializes a new ribbon category for the ribbon bar.

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

Name of the ribbon category.

[in] uiSmallImagesResID

Resource ID of the small image list for the ribbon category.

[in] uiLargeImagesResID

Resource ID of the large image list for the ribbon category.

[in] sizeSmallImage

Specifies the size of small images for the ribbon category.

[in] sizeLargeImage

Specifies the size of large images for the ribbon category.

[in] nInsertAt

Zero based index of the category location.

[in] pRTI

Pointer to a CMFCRibbonCategory Class run-time class to dynamically create a ribbon category at run-time.

A pointer to the new ribbon category if the method was successful; otherwise, NULL.

If the pRTI parameter is not NULL, the new ribbon category is created dynamically using the run-time class.

The following example demonstrates how to use the AddCategory method in the CMFCRibbonBar class.

C++
Copy 

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

Header: afxribbonbar.h

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.