CMFCRibbonColorButton クラス
CMFCRibbonColorButton クラスは、リボン バーに追加できるカラー ボタンを実装します。リボンのカラー ボタンは、1 つまたは複数のカラー パレットを含むドロップダウン メニューを表示します。
class CMFCRibbonColorButton : public CMFCRibbonGallery
メンバー
.gif "Bb983440.collapse_all(ja-jp,VS.110).gif")
パブリック コンストラクター
名前 |
説明 |
|---|---|
|
パブリック メソッド
名前 |
説明 |
|---|---|
色のグループを通常の色領域に追加します。 |
|
[自動] ボタンを有効にするかどうかを指定します。 |
|
[その他] ボタンを有効にします。 |
|
|
|
現在選択されている色を返します。 |
|
カラー バーに表示されるカラー要素のサイズを返します。 |
|
|
|
ポップアップ カラー パレットで現在選択されている要素の色を返します。 |
|
通常の色領域からすべての色のグループを削除します。 |
|
通常の色領域から色を選択します。 |
|
カラー バーに表示されるすべてのカラー要素のサイズを設定します。 |
|
|
|
|
|
ドキュメントの色領域に表示する RGB 値のリストを指定します。 |
|
|
|
|
解説
ユーザーがリボンのカラー ボタンを押すと、カラー バーが表示されます。既定では、このカラー バーには通常の色領域と呼ばれる色選択パレットが含まれます。必要な場合は、カラー バーには [自動] ボタン (これを使用するとユーザーは既定の色を選択できます)、および [その他] ボタン (追加の色を含むカラー パレットがポップアップ表示されます) が表示されます。
使用例
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 );
継承階層
必要条件
ヘッダー : afxribboncolorbutton.h