CMFCRibbonColorButton クラス

[アーティクル]
08/09/2011

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

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 値の一覧の指定の方法を示します。このコードスニペットは、「DrawClient サンプル:MFC リボンベースの OLE オブジェクトの描画アプリケーション」の一部です。

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