Ribbon Main (Application) Button ("Perl")

The Microsoft® Office-style Ribbon Main Button (CBCGPRibbonMainButton) is a special button located at the left top corner of application window and displays a menu, which usually contains "File" commands like Open, Save, Exit.

In addition, the application menu has recent files list and search box.

Office 2007-style Application Button:

Windows "Scenic"-style Application Button:

Sample code:

CBCGPRibbonMainButton	m_MainButton;
...
// Suggested size is 26 x 26 pixels
m_MainButton.SetImage (IDB_MAIN); 
m_MainButton.SetToolTipText (_T("File"));

m_wndRibbonBar.SetMainButton(
	&m_MainButton, CSize(45, 45));

CBCGPRibbonMainPanel* pMainPanel = 
	m_wndRibbonBar.AddMainCategory (
	_T("File"), IDB_FILESMALL, IDB_FILELARGE);

pMainPanel->Add(new CBCGPRibbonButton
	(ID_FILE_NEW, _T("New"), 0, 0));
pMainPanel->Add(new CBCGPRibbonButton
	(ID_FILE_OPEN, _T("Open..."), 1, 1));
pMainPanel->Add (new CBCGPRibbonButton
	(ID_FILE_SAVE, _T("Save"), 2, 2));
pMainPanel->Add (new CBCGPRibbonButton
	(ID_FILE_SAVE_AS, _T("Save As..."), 3, 3));

CBCGPRibbonButton* pBtnPrint = 
	new CBCGPRibbonButton(
		ID_FILE_PRINT, _T("Print"), 6, 6);

pBtnPrint->AddSubItem (new CBCGPRibbonLabel
	(_T("Preview and print the document")));
pBtnPrint->AddSubItem (
	new CBCGPRibbonButton
		(ID_FILE_PRINT_DIRECT, 
		_T("Quick Print"), 6, 6, TRUE));
pBtnPrint->AddSubItem (
	new CBCGPRibbonButton
		(ID_FILE_PRINT_PREVIEW, 
		_T("Print Preview"), 12, 12, TRUE));

pMainPanel->Add(pBtnPrint);

pMainPanel->Add (new CBCGPRibbonSeparator (TRUE));
pMainPanel->Add (new CBCGPRibbonButton
	(ID_FILE_CLOSE, _T("Close"), 7, 7));

pMainPanel->AddRecentFilesList(
	_T("Recent Documents"));

pMainPanel->AddToBottom (
	new CBCGPRibbonMainPanelButton (
		ID_APP_EXIT, _T("Exit"), 9));

---