CMFCColorPickerCtrl クラス

  • [アーティクル]

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 コントロールをダイアログ ボックスに組み込むには、次の手順を実行します。

  1. ClassWizard を使用する場合は、ダイアログ ボックス テンプレートに新しいボタン コントロールを挿入します (CMFCColorPickerCtrl クラスはCButton クラスから継承されるため)。

  2. 新しいボタン コントロールに関連付けられているメンバー変数をダイアログ ボックス クラスに挿入します。 次に、変数の型を CButton から CMFCColorPickerCtrl に変更します。

  3. ダイアログ ボックス クラスの WM_INITDIALOG メッセージ ハンドラーを挿入します。 ハンドラーで、 CMFCColorPickerCtrl コントロールの種類、パレット、および最初に選択した色を設定します。

継承階層

CObject
CCmdTarget
CWnd
CButton
CMFCColorPickerCtrl

要件

ヘッダー: afxcolorpickerctrl.h

CMFCColorPickerCtrl::CMFCColorPickerCtrl

CMFCColorPickerCtrl オブジェクトを構築します。

CMFCColorPickerCtrl();

戻り値

解説

CMFCColorPickerCtrl::DrawCursor

選択した色を指すカーソルが表示される前に、フレームワークによって呼び出されます。

virtual void DrawCursor(
    CDC* pDC,
    const CRect& rect);

パラメーター

pDC
[in]デバイス コンテキストへのポインター。

rect
[in]選択した色の周囲の四角形領域を指定します。

解説

選択した色を指すカーソルの形状を変更する必要がある場合は、このメソッドをオーバーライドします。

CMFCColorPickerCtrl::GetColor

ユーザーが選択した色を取得します。

COLORREF GetColor() const;

戻り値

選択した色の RGB 値。

解説

CMFCColorPickerCtrl::GetHLS

ユーザーが選択した色の色相、輝度、彩度の値を取得します。

void GetHLS(
    double* hue,
    double* luminance,
    double* saturation);

パラメーター

hue
[out]hue 情報を受け取る double 型の変数へのポインター。

luminance
[out]輝度情報を受け取る double 型の変数へのポインター。

saturation
[out]飽和情報を受け取る double 型の変数へのポインター。

解説

CMFCColorPickerCtrl::GetHue

ユーザーが選択した色の色相成分を取得します。

double GetHue() const;

戻り値

選択した色の色相成分。

解説

CMFCColorPickerCtrl::GetLuminance

ユーザーが選択した色の輝度コンポーネントを取得します。

double GetLuminance() const;

戻り値

選択した色の輝度コンポーネント。

解説

CMFCColorPickerCtrl::GetSaturation

ユーザーが選択した色の彩度の値を取得します。

double GetSaturation() const;

戻り値

選択した色の彩度成分。

解説

CMFCColorPickerCtrl::SelectCellHexagon

現在の色を、指定した RGB カラー コンポーネントまたは指定したセル六角形によって定義された色に設定します。

void SelectCellHexagon(
    BYTE R,
    BYTE G,
    BYTE B);

BOOL SelectCellHexagon(
    int x,
    int y);

パラメーター

R
[in]赤い色のコンポーネント。

G
[in]緑色のコンポーネント。

B
[in]青い色のコンポーネント。

x
[in]セルの六角形を指すカーソルの x 座標。

y
[in]セルの六角形を指すカーソルの y 座標。

戻り値

このメソッドの 2 番目のオーバーロードは常に FALSE を返します。

解説

このメソッドの最初のオーバーロードは、現在の色を、色選択コントロールの指定された赤、緑、青の色コンポーネントに対応する色に設定します。

このメソッドの 2 番目のオーバーロードは、現在の色を、指定したカーソル位置によって指されるセル六角形の色に設定します。

CMFCColorPickerCtrl::SetColor

現在の色を指定した RGB カラー値に設定します。

void SetColor(COLORREF Color);

パラメーター

Color
[in]RGB カラー値。

解説

CMFCColorPickerCtrl::SetHLS

現在の色を指定した HLS カラー値に設定します。

void SetHLS(
    double hue,
    double luminance,
    double saturation,
    BOOL bInvalidate=TRUE);

パラメーター

hue
[in]色相の値。

luminance
[in]輝度値。

saturation
[in]飽和値。

bInvalidate
[入力] TRUE ウィンドウが新しい色にすぐに更新するように強制する場合。それ以外の場合は FALSE。 既定値は、TRUE です。

解説

CMFCColorPickerCtrl::SetHue

現在選択されている色の色合いを変更します。

void SetHue(double Hue);

パラメーター

Hue
[in]色相の値。

解説

CMFCColorPickerCtrl::SetLuminance

現在選択されている色の輝度を変更します。

void SetLuminance(double Luminance);

パラメーター

Luminance
[in]輝度値。

解説

CMFCColorPickerCtrl::SetLuminanceBarWidth

カラー ピッカー コントロールの輝度バーの幅を設定します。

void SetLuminanceBarWidth(int w);

パラメーター

w
[in]ピクセル単位で測定される輝度バーの幅。

解説

このメソッドを使用して、カラー ピッカー コントロールの Custom タブにある輝度バーのサイズを変更します。 w パラメーターは、輝度バーの新しい幅を指定します。 幅の値は、クライアント領域の幅の 4 分の 3 を超える場合は無視されます。

CMFCColorPickerCtrl::SetOriginalColor

最初に選択した色を設定します。

void SetOriginalColor(COLORREF ref);

パラメーター

ref
[in]RGB カラー値。

解説

カラー ピッカー コントロールが初期化されるときに、このメソッドを呼び出します。

CMFCColorPickerCtrl::SetPalette

現在のカラー パレットを設定します。

void SetPalette(CPalette* pPalette);

パラメーター

pPalette
[in]カラー パレットへのポインター。

解説

カラー パレットは、カラー ピッカー コントロールに表示される色の配列を定義します。

CMFCColorPickerCtrl::SetSaturation

現在選択されている色の彩度を変更します。

void SetSaturation(double Saturation);

パラメーター

Saturation
[in] 飽和値。

解説

CMFCColorPickerCtrl::SetType

表示するカラー ピッカー コントロールの種類を設定します。

void SetType(COLORTYPE colorType);

パラメーター

colorType
[in]カラー ピッカー コントロールの種類。

型は、 CMFCColorPickerCtrl::COLORTYPE 列挙型によって定義されます。 使用できる型は、 LUMINANCE、 PICKER、 HEX 、および HEX_GREYSCALEです。 既定の型は PICKER です。

解説

カラー ピッカー コントロールの種類を指定するには、Windows コントロールを作成する前にこのメソッドを呼び出します。

関連項目

階層図
クラス
CMFCColorDialog クラス