Home Library Learn Samples Downloads Support Community Forums
MSDN Library
Development Tools and Languages
Visual Studio 2012
Visual C++
MFC and ATL
MFC Desktop Applications
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::AddMainCategory

Visual Studio 2012

Creates a new main ribbon category for the ribbon bar.

Copy 
CMFCRibbonMainPanel* AddMainCategory(
   LPCTSTR lpszName,
   UINT uiSmallImagesResID,
   UINT uiLargeImagesResID,
   CSize sizeSmallImage = CSize(16, 16),
   CSize sizeLargeImage = CSize(32, 32) 
);
[in] lpszName

Name of the main ribbon category.

[in] uiSmallImagesResID

Resource ID of small images.

[in] uiLargeImagesResID

Resource ID of large images.

[in] sizeSmallImage

The size of small images.

[in] sizeLargeImage

The size of large images.

Pointer to the new main ribbon category if the method was successful; otherwise, NULL.

If a main ribbon category already exists, it is deleted.

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

C++
Copy 
	// 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);

Header: afxribbonbar.h

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.