CMFCRibbonColorButton选件类

项目
03/01/2013

CMFCRibbonColorButton 选件类实现可以添加到功能区栏的颜色按钮。功能区颜色按钮显示包含一个或多个调色板的一个下拉菜单。

class CMFCRibbonColorButton : public CMFCRibbonGallery

成员

公共构造函数

名称	说明
CMFCRibbonColorButton::CMFCRibbonColorButton

公共方法

名称	说明
CMFCRibbonColorButton::AddColorsGroup	添加颜色的一组到规则颜色区域。
CMFCRibbonColorButton::EnableAutomaticButton	指定自动按钮是否启用。
CMFCRibbonColorButton::EnableOtherButton	启用其他按钮。
CMFCRibbonColorButton::GetAutomaticColor
CMFCRibbonColorButton::GetColor	返回当前选定的颜色。
CMFCRibbonColorButton::GetColorBoxSize	返回出现在对有色人种的、颜色的元素的大小。
CMFCRibbonColorButton::GetColumns
CMFCRibbonColorButton::GetHighlightedColor	返回当前所选元素的颜色在弹出调色板的。
CMFCRibbonColorButton::RemoveAllColorGroups	从规则颜色区移除所有颜色组。
CMFCRibbonColorButton::SetColor	选择一种颜色从规则颜色区域。
CMFCRibbonColorButton::SetColorBoxSize	设置将显示在对有色人种的、所有颜色的元素的大小。
CMFCRibbonColorButton::SetColorName
CMFCRibbonColorButton::SetColumns
CMFCRibbonColorButton::SetDocumentColors	在文档颜色领域指定RGB值列表显示。
CMFCRibbonColorButton::SetPalette
CMFCRibbonColorButton::UpdateColor

备注

当用户按时，功能区颜色按钮显示为有色人种的区别不同。默认情况下，为有色人种的、包含调用常规颜色区域的颜色调色板选择。或者，若要有色人种的、可以显示自动按钮，允许用户选择默认颜色和其他按钮，显示一个弹出调色板包含其他的颜色。

示例

下面的示例在 CMFCRibbonColorButton 选件类演示如何使用各种方法。此示例演示如何构造 CMFCRibbonColorButton 对象，并设置大图像，启用自动按钮，启用其他按钮，将列数，将文档颜色区域显示在对有色人种的区别不同，颜色添加到常规颜色区域，并指定RGB值列表显示所有颜色的元素的大小。此代码段是绘制客户端示例的一部分。

    // Create the "Paper Color" button
    CMFCRibbonColorButton* pBtnPaperColor = new CMFCRibbonColorButton(ID_VIEW_PAPERCOLOR, _T("Paper Color\ng"), TRUE, 13, 1);
    pBtnPaperColor->SetAlwaysLargeImage();
    pBtnPaperColor->EnableAutomaticButton(_T("&Automatic"), RGB(255, 255, 255));
    pBtnPaperColor->EnableOtherButton(_T("&More Colors..."), _T("More Colors"));
    pBtnPaperColor->SetColumns(10);
    pBtnPaperColor->SetColorBoxSize(CSize(17, 17));
    // CList<COLORREF,COLORREF> m_lstMainColors
    pBtnPaperColor->AddColorsGroup(_T("Theme Colors"), m_lstMainColors, TRUE);
    // CList<COLORREF,COLORREF> m_lstAdditionalColors
    pBtnPaperColor->AddColorsGroup(_T(""), m_lstAdditionalColors, FALSE);
    // CList<COLORREF,COLORREF> m_lstStandardColors
    pBtnPaperColor->AddColorsGroup(_T("Standard Colors"), m_lstStandardColors, TRUE);
    CList<COLORREF,COLORREF> lstColors;
    lstColors.AddTail(RGB(255,0,0));
    lstColors.AddTail(RGB(0,255,0));
    lstColors.AddTail(RGB(0,0,255));
    pBtnPaperColor->SetDocumentColors( _T("Document Colors"), lstColors );