CMFCRibbonColorButton 類別

發行項
02/28/2013

CMFCRibbonColorButton 類別實作可以加入至功能區列上的按鈕。功能區按鈕色彩顯示包含一或多個色板的下拉式功能表。

class CMFCRibbonColorButton : public CMFCRibbonGallery

Members

公用建構函式

名稱	描述
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 );