CMFCRibbonButton选件类

项目
03/01/2013

CMFCRibbonButton 选件类实现自己在功能区栏元素可以确定例如面板、快速访问工具栏和弹出菜单的按钮。

class CMFCRibbonButton : public CMFCRibbonBaseElement

成员

公共构造函数

名称	说明
CMFCRibbonButton::CMFCRibbonButton	构造功能区按钮对象。

公共方法

名称	说明
CMFCRibbonButton::AddSubItem	将菜单项添加到与按钮的弹出菜单。
CMFCRibbonButton::CanBeStretched	（重写 CMFCRibbonBaseElement::CanBeStretched。）
CMFCRibbonButton::CleanUpSizes	（重写 CMFCRibbonBaseElement::CleanUpSizes。）
CMFCRibbonButton::ClosePopupMenu	（重写 CMFCRibbonBaseElement::ClosePopupMenu。）
CMFCRibbonButton::DrawBottomText
CMFCRibbonButton::DrawImage	（重写 CMFCRibbonBaseElement::DrawImage。）
CMFCRibbonButton::DrawRibbonText
CMFCRibbonButton::FindSubItemIndexByID	返回与指定的命令ID.弹出菜单项的索引
CMFCRibbonButton::GetCommandRect
CMFCRibbonButton::GetCompactSize	返回功能区元素的袖珍型。（重写 CMFCRibbonBaseElement::GetCompactSize。）
CMFCRibbonButton::GetIcon
CMFCRibbonButton::GetImageIndex	返回与按钮图像的索引。
CMFCRibbonButton::GetImageSize	返回功能区元素的图像大小。（重写 CMFCRibbonBaseElement::GetImageSize。）
CMFCRibbonButton::GetIntermediateSize	返回功能区元素的大小在其元状态的。（重写 CMFCRibbonBaseElement::GetIntermediateSize。）
CMFCRibbonButton::GetMenu	返回处理对分配给区按钮的Windows菜单。
CMFCRibbonButton::GetMenuRect
CMFCRibbonButton::GetRegularSize	返回功能区元素的常规大小。（重写 CMFCRibbonBaseElement::GetRegularSize。）
CMFCRibbonButton::GetSubItems
CMFCRibbonButton::GetTextRowHeight
CMFCRibbonButton::GetToolTipText	返回功能区元素的工具提示文本。（重写 CMFCRibbonBaseElement::GetToolTipText。）
CMFCRibbonButton::HasCompactMode	指定功能区元素是否具有compact模式。（重写 CMFCRibbonBaseElement::HasCompactMode。）
CMFCRibbonButton::HasIntermediateMode	指定功能区元素是否具有中间模式。（重写 CMFCRibbonBaseElement::HasIntermediateMode。）
CMFCRibbonButton::HasLargeMode	确定功能区元素是否有大型架构。（重写 CMFCRibbonBaseElement::HasLargeMode。）
CMFCRibbonButton::HasMenu	（重写 CMFCRibbonBaseElement::HasMenu。）
CMFCRibbonButton::IsAlwaysDrawBorder
CMFCRibbonButton::IsAlwaysLargeImage	（重写 CMFCRibbonBaseElement::IsAlwaysLargeImage。）
CMFCRibbonButton::IsApplicationButton
CMFCRibbonButton::IsCommandAreaHighlighted
CMFCRibbonButton::IsDefaultCommand	确定是否启用了功能区按钮的默认命令。
CMFCRibbonButton::IsDefaultPanelButton
CMFCRibbonButton::IsDrawTooltipImage
CMFCRibbonButton::IsLargeImage
CMFCRibbonButton::IsMenuAreaHighlighted
CMFCRibbonButton::IsMenuOnBottom
CMFCRibbonButton::IsPopupDefaultMenuLook
CMFCRibbonButton::IsRightAlignMenu	确定菜单是否是右对齐的。
CMFCRibbonButton::IsSingleLineText
CMFCRibbonButton::OnCalcTextSize	（重写 CMFCRibbonBaseElement::OnCalcTextSize。）
CMFCRibbonButton::OnDrawBorder
CMFCRibbonButton::OnDraw	调用由框架绘制功能区元素。（重写 CMFCRibbonBaseElement::OnDraw。）
CMFCRibbonButton::OnFillBackground
CMFCRibbonButton::RemoveAllSubItems	从弹出菜单移除所有菜单项。
CMFCRibbonButton::RemoveSubItem	从弹出菜单移除菜单项。
CMFCRibbonButton::SetACCData	（重写 CMFCRibbonBaseElement::SetACCData。）
CMFCRibbonButton::SetAlwaysLargeImage	指定按钮是否显示一个大或一个小图像，当用户折叠按钮。
CMFCRibbonButton::SetDefaultCommand	启用功能区按钮的默认命令。
CMFCRibbonButton::SetDescription	设置功能区元素的说明。（重写 CMFCRibbonBaseElement::SetDescription。）
CMFCRibbonButton::SetImageIndex	索引分配给按钮的图像。
CMFCRibbonButton::SetMenu	分配弹出菜单到功能区按钮。
CMFCRibbonButton::SetParentCategory	（重写 CMFCRibbonBaseElement::SetParentCategory。）
CMFCRibbonButton::SetRightAlignMenu	在按钮右侧对齐弹出菜单。
CMFCRibbonButton::SetText	设置功能区元素的文本。（重写 CMFCRibbonBaseElement::SetText。）

受保护的方法

名称	说明
CMFCRibbonButton::OnClick	调用由结构，当用户单击按钮。

示例

下面的示例在 CMFCRibbonButton 选件类演示如何使用各种方法。此示例演示如何构造对象 CMFCRibbonButton 选件类，并将弹出菜单到功能区按钮，将按钮的说明，从弹出菜单移除菜单项，并且，正确将弹出菜单到按钮的边缘。

    strTemp.LoadString(IDS_RIBBON_STYLE);
    // The first parameter is the command ID of the button.
    // The third parameter is a zero-based index of the button's small image in the 
    // image list of the parent category.
    // The fourth parameter is a zero-based index of the button's large image in the 
    // image list of the parent category.
    CMFCRibbonButton* pVisualStyleButton = new CMFCRibbonButton(1, strTemp, -1, -1);
    
    pVisualStyleButton->SetMenu(IDR_THEME_MENU, TRUE, TRUE);

    strTemp.LoadString(IDS_RIBBON_STYLE_TIP);
    pVisualStyleButton->SetToolTipText(strTemp);
    strTemp.LoadString(IDS_RIBBON_STYLE_DESC);
    pVisualStyleButton->SetDescription(strTemp);
    pVisualStyleButton->RemoveSubItem(0);
    pVisualStyleButton->SetRightAlignMenu(TRUE);

备注

若要使用功能区按钮在应用程序，请构造按钮对象并将其添加到相应的功能区面板。

CMFCRibbonPanel* pPanel = pCategory->AddPanel (
    _T("Clipboard"),                       // Panel name
    m_PanelIcons.ExtractIcon (0));  // Panel icon
// Create the first button ("Paste"):
CMFCRibbonButton* pPasteButton = 
    new CMFCRibbonButton (ID_EDIT_PASTE, _T("Paste"), -1, 0);
// The third parameter (-1) disables small images for button.
// This button is always displayed with a large image
// Associate a pop-up menu with the "Paste" button:
pPasteButton->SetMenu (IDR_CONTEXT_MENU);
// Add buttons to the panel. These buttons have only small images.
pPanel->Add (new CMFCRibbonButton (ID_EDIT_CUT, _T("Cut"), 1));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_COPY, _T("Copy"), 2));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_PAINT, _T("Paint"), 9));