CMFCColorPickerCtrl クラス

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

CMFCColorPickerCtrl クラスは、色の選択に使用するコントロールの機能を提供します。

class CMFCColorPickerCtrl : public CButton

メンバー

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

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

パブリックメソッド

[名前]	説明
CMFCColorPickerCtrl::GetColor	ユーザーが選択した色を取得します。
CMFCColorPickerCtrl::GetHLS	ユーザーが選択した色の色合い、輝度、および彩度の値を取得します。
CMFCColorPickerCtrl::GetHue	ユーザーが選択した色の、色合いコンポーネントを取得します。
CMFCColorPickerCtrl::GetLuminance	ユーザーが選択した色の輝度コンポーネントを取得します。
CMFCColorPickerCtrl::GetSaturation	ユーザーが選択した色の彩度コンポーネントを取得します。
CMFCColorPickerCtrl::SelectCellHexagon	現在の色を、指定した RGB 色要素または指定したセル六角形で定義された色に設定します。
CMFCColorPickerCtrl::SetColor	現在の色を、指定した RGB カラー値に設定します。
CMFCColorPickerCtrl::SetHLS	現在の色を、指定した HLS カラー値に設定します。
CMFCColorPickerCtrl::SetHue	現在選択されている色の色合いコンポーネントを変更します。
CMFCColorPickerCtrl::SetLuminance	現在選択されている色の輝度コンポーネントを変更します。
CMFCColorPickerCtrl::SetLuminanceBarWidth	カラーピッカーコントロールの輝度バーの幅を設定します。
CMFCColorPickerCtrl::SetOriginalColor	最初に選択する色を設定します。
CMFCColorPickerCtrl::SetPalette	現在のカラーパレットを設定します。
CMFCColorPickerCtrl::SetSaturation	現在選択されている色の彩度コンポーネントを変更します。
CMFCColorPickerCtrl::SetType	表示するカラーピッカーコントロールの種類を設定します。

プロテクトメソッド

[名前]	説明
CMFCColorPickerCtrl::DrawCursor	選択した色をポイントするカーソルを表示する前に、フレームワークによって呼び出されます。

解説

標準色は六角形カラーパレットから選択され、カスタム色は輝度バーから選択されます。輝度バーでは、色を赤/緑/青または色合い/彩度/輝度で指定します。

次の図に CMFCColorPickerCtrl オブジェクトをいくつか示します。

CMFCColorPickerCtrl ダイアログボックス

CMFCColorPickerCtrl はスタイルのペアを 2 組サポートします。標準色の選択には HEX スタイルと HEX_GREYSCALE スタイルが適しています。カスタム色の選択には、PICKER スタイルと LUMINANCE スタイルが適しています。

CMFCColorPickerCtrl コントロールをダイアログボックスに組み込むには、次の手順に従います。

ClassWizard を使用する場合は、新しいボタンコントロールをダイアログボックステンプレートに挿入します (CMFCColorPickerCtrl クラスが CButton クラスを継承しているため)。
新しいボタンコントロールに関連付けられているメンバー変数をダイアログボックスクラスに挿入します。次に、変数の型を CButton から CMFCColorPickerCtrl に変更します。
ダイアログボックスクラスの WM_INITDIALOG メッセージハンドラーを挿入します。ハンドラーで、CMFCColorPickerCtrl コントロールの種類、パレット、および初期選択色を設定します。

使用例

次の例は、CMFCColorPickerCtrl クラスのさまざまなメソッドを使用して CMFCColorPickerCtrl オブジェクトを構成する方法について説明しています。具体的には、ピッカーコントロールの種類の設定方法と、その色、色合い、輝度、および彩度の設定方法を示しています。この例は、「NewControls サンプル:MFC コントロールデモンストレーションアプリケーション」の一部です。

    CMFCColorPickerCtrl m_wndLum;


...


    // CPalette m_palSys
    // set the type of the color picker control
    m_wndLum.SetType(CMFCColorPickerCtrl::LUMINANCE);
    m_wndLum.SetPalette(&m_palSys);
    // set the color, hue, luminance and saturation of the color picker control
    m_wndLum.SetColor(RGB(0, 255, 0));
    m_wndLum.SetHue(0.5);
    m_wndLum.SetLuminance(2.5);
    m_wndLum.SetLuminanceBarWidth(10);
    m_wndLum.SetSaturation(0.5);