次の方法で共有


CMFCRibbonColorButton クラス

CMFCRibbonColorButton クラスは、リボン バーに追加できるカラー ボタンを実装します。リボンのカラー ボタンは、1 つまたは複数のカラー パレットを含むドロップダウン メニューを表示します。

class CMFCRibbonColorButton : public CMFCRibbonGallery

メンバー

Bb983440.collapse_all(ja-jp,VS.110).gifパブリック コンストラクター

名前

説明

CMFCRibbonColorButton::CMFCRibbonColorButton

 

Bb983440.collapse_all(ja-jp,VS.110).gifパブリック メソッド

名前

説明

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 );

継承階層

CObject

   CMFCRibbonBaseElement

      CMFCRibbonButton

         CMFCRibbonGallery

            CMFCRibbonColorButton

必要条件

ヘッダー : afxribboncolorbutton.h

参照

関連項目

階層図

CMFCRibbonGallery クラス

その他の技術情報

MFC クラス