CMFCColorMenuButton クラス

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

CMFCColorMenuButton クラスは、カラーピッカーダイアログボックスを起動するメニューコマンドまたはツールバーのボタンをサポートします。

class CMFCColorMenuButton : public CMFCToolBarMenuButton

メンバー

パブリックコンストラクター

[名前]	説明
CMFCColorMenuButton::CMFCColorMenuButton	CMFCColorMenuButton オブジェクトを構築します。

パブリックメソッド

[名前]	説明
CMFCColorMenuButton::EnableAutomaticButton	標準のカラーボタンの上にある "自動" ボタンを有効または無効にします (標準システムの自動ボタンのラベルは [自動] です)。
CMFCColorMenuButton::EnableDocumentColors	システムカラーの代わりにドキュメント固有の色を表示できるようにします。
CMFCColorMenuButton::EnableOtherButton	標準のカラーボタンの下にある "その他" ボタンを有効または無効にします (標準的なシステムの "その他" ボタンのラベルは [その他の色] です)。
CMFCColorMenuButton::EnableTearOff	カラーペインのティアオフ機能を有効にします。
CMFCColorMenuButton::GetAutomaticColor	現在の自動設定の色を取得します。
CMFCColorMenuButton::GetColor	現在のボタンの色を取得します。
CMFCColorMenuButton::GetColorByCmdID	指定されたコマンド ID に対応する色を取得します。
CMFCColorMenuButton::OnChangeParentWnd	親ウィンドウが変更されたときに、フレームワークによって呼び出されます。
CMFCColorMenuButton::OpenColorDialog	色を選択するためのダイアログボックスを開きます。
CMFCColorMenuButton::SetColor	現在のカラーボタンの色を設定します。
CMFCColorMenuButton::SetColorByCmdID	指定されたカラーメニューボタンの色を設定します。
CMFCColorMenuButton::SetColorName	指定した色の新しい名前を設定します。
CMFCColorMenuButton::SetColumnsNumber	CMFCColorBar オブジェクトにより表示される列数を設定します。

プロテクトメソッド

[名前]	説明
CMFCColorMenuButton::CopyFrom	別のツールバーボタンを現在のボタンにコピーします。
CMFCColorMenuButton::CreatePopupMenu	カラーピッカーダイアログボックスを作成します。
CMFCColorMenuButton::IsEmptyMenuAllowed	空のメニューがサポートされるかどうかを示します。
CMFCColorMenuButton::OnDraw	ボタンのイメージを表示するために、フレームワークによって呼び出されます。
CMFCColorMenuButton::OnDrawOnCustomizeList	ツールバーカスタマイズダイアログボックスの一覧に CMFCColorMenuButton オブジェクトが表示される前に、フレームワークによって呼び出されます。

解説

元のメニューコマンドまたはツールバーボタンを CMFCColorMenuButton オブジェクトと置き換えるには、CMFCColorMenuButton オブジェクトを作成して適切な CMFCColorBar クラススタイルを設定し、CMFCToolBar クラスクラスの ReplaceButton メソッドを呼び出します。ツールバーをカスタマイズする場合は、CMFCToolBarsCustomizeDialog::ReplaceButton メソッドを呼び出します。

CMFCColorMenuButton::CreatePopupMenu イベントハンドラーの処理中に、カラーピッカーダイアログボックスが作成されます。イベントハンドラーは、WM_COMMAND メッセージによって親フレームに通知します。 CMFCColorMenuButton オブジェクトは、元のメニューコマンドまたはツールバーボタンに割り当てられたコントロール ID を送信します。

使用例

CMFCColorMenuButton クラスのさまざまなメソッドを使用して、カラーメニューボタンを作成して設定する方法を次の例に示します。この例では、まず CPalette オブジェクトを作成した後、このオブジェクトを使用して CMFCColorMenuButton クラスのオブジェクトを構築します。次に、"自動" ボタンと "その他" ボタンを有効にしてその色と列数を設定することで、CMFCColorMenuButton オブジェクトを設定します。このコードは、「ワードパッドのサンプル:MFC ワードパッドアプリケーション」の一部です。

    CPalette    m_palColorPicker;   // Palette for color picker
    int         m_nNumColours;


...


CMFCColorMenuButton* CFormatBar::CreateColorButton ()
{
    if (m_palColorPicker.GetSafeHandle () == NULL)
    {
        m_nNumColours = sizeof (crColours)/sizeof(ColourTableEntry);
        ASSERT(m_nNumColours <= MAX_COLOURS);
        if (m_nNumColours > MAX_COLOURS)
            m_nNumColours = MAX_COLOURS;

        // Create the palette
        struct 
        {
            LOGPALETTE    LogPalette;
            PALETTEENTRY  PalEntry[MAX_COLOURS];
        }pal;

        LOGPALETTE* pLogPalette = (LOGPALETTE*) &pal;
        pLogPalette->palVersion    = 0x300;
        pLogPalette->palNumEntries = (WORD) m_nNumColours; 

        for (int i = 0; i < m_nNumColours; i++)
        {
            pLogPalette->palPalEntry[i].peRed   = GetRValue(crColours[i].crColour);
            pLogPalette->palPalEntry[i].peGreen = GetGValue(crColours[i].crColour);
            pLogPalette->palPalEntry[i].peBlue  = GetBValue(crColours[i].crColour);
            pLogPalette->palPalEntry[i].peFlags = 0;
        }

        m_palColorPicker.CreatePalette (pLogPalette);
    }


    CMFCColorMenuButton* pColorButton = new 
        CMFCColorMenuButton (ID_CHAR_COLOR, _T("Text Color..."), &m_palColorPicker);

    pColorButton->EnableAutomaticButton (_T("Automatic"), RGB (0, 0, 0));
    pColorButton->EnableOtherButton (_T("More Colors..."));
    pColorButton->EnableDocumentColors (_T("Document's Colors"));
    pColorButton->EnableTearOff (ID_COLOR_TEAROFF, 5, 2);
    pColorButton->SetColumnsNumber (8);
    pColorButton->SetColor(RGB(0,0,255));

    // Initialize color names:
    for (int i = 0; i < m_nNumColours; i++)
    {
        CMFCColorMenuButton::SetColorName (crColours[i].crColour, crColours[i].szName);
    }

    return pColorButton;
}