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::D rawCursor | 選択した色を指すカーソルが表示される前に、フレームワークによって呼び出されます。 |
解説
標準色は六角形のカラー パレットから選択され、カスタムカラーは、赤/緑/青表記または色相/サトゥアレーション/輝度表記を使用して色を指定する輝度バーから選択されます。
次の図は、いくつかの CMFCColorPickerCtrl
オブジェクトを示しています。
CMFCColorPickerCtrl
2 組のスタイルがサポートされています。 HEX スタイルと HEX_GREYSCALE スタイルは、標準の色選択に適しています。 ピッカースタイルと輝度スタイルは、ユーザー設定の色選択に適しています。
ダイアログ ボックスにコントロールを組み込むには、次の CMFCColorPickerCtrl
手順を実行します。
ClassWizard を使用する場合は、ダイアログ ボックス テンプレートに新しいボタン コントロールを挿入します (クラスはクラスから
CButton
継承されるためCMFCColorPickerCtrl
)。新しいボタン コントロールに関連付けられているメンバー変数をダイアログ ボックス クラスに挿入します。 次に、変数の型を次のように
CButton
変更しますCMFCColorPickerCtrl
。ダイアログ ボックス クラスの
WM_INITDIALOG
メッセージ ハンドラーを挿入します。 ハンドラーで、コントロールの種類、パレット、および最初に選択した色をCMFCColorPickerCtrl
設定します。
例
次の例では、クラスのさまざまなメソッドを CMFCColorPickerCtrl
使用してオブジェクトを構成する方法を CMFCColorPickerCtrl
示します。 この例では、ピッカー コントロールの種類を設定する方法と、その色、色相、輝度、彩度を設定する方法を示します。 この例は、新しいコントロールのサンプルの一部です。
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);
継承階層
必要条件
ヘッダー: afxcolorpickerctrl.h
CMFCColorPickerCtrl::CMFCColorPickerCtrl
CMFCColorPickerCtrl
オブジェクトを構築します。
CMFCColorPickerCtrl();
戻り値
解説
CMFCColorPickerCtrl::D rawCursor
選択した色を指すカーソルが表示される前に、フレームワークによって呼び出されます。
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);
パラメーター
色相
[out]hue 情報を受け取る double 型の変数へのポインター。
輝度
[out]輝度情報を受け取る double 型の変数へのポインター。
彩度
[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 番目のオーバーロードは常に FAL Standard Edition を返します。
解説
このメソッドの最初のオーバーロードは、現在の色を、色選択コントロールの指定された赤、緑、青の色コンポーネントに対応する色に設定します。
このメソッドの 2 番目のオーバーロードは、現在の色を、指定したカーソル位置によって指されるセル六角形の色に設定します。
CMFCColorPickerCtrl::SetColor
現在の色を指定した RGB カラー値に設定します。
void SetColor(COLORREF Color);
パラメーター
色
[in]RGB カラー値。
解説
CMFCColorPickerCtrl::SetHLS
現在の色を指定した HLS カラー値に設定します。
void SetHLS(
double hue,
double luminance,
double saturation,
BOOL bInvalidate=TRUE);
パラメーター
色相
[in]色相の値。
輝度
[in]輝度値。
彩度
[in]飽和値。
bInvalidate
[in]ウィンドウを強制的に新しい色にすぐに更新する場合は TRUE。それ以外の場合は FAL Standard Edition。 既定値は TRUE です。
解説
CMFCColorPickerCtrl::SetHue
現在選択されている色の色合いを変更します。
void SetHue(double Hue);
パラメーター
Hue
[in]色相の値。
解説
CMFCColorPickerCtrl::SetLuminance
現在選択されている色の輝度を変更します。
void SetLuminance(double Luminance);
パラメーター
輝度
[in]輝度値。
解説
CMFCColorPickerCtrl::SetLuminanceBarWidth
カラー ピッカー コントロールの輝度バーの幅を設定します。
void SetLuminanceBarWidth(int w);
パラメーター
w
[in]ピクセル単位で測定される輝度バーの幅。
解説
カラー ピッカー コントロールの [カスタム] タブにある輝度バーのサイズを変更するには、このメソッドを使用します。 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);
パラメーター
彩度
[in]飽和値。
解説
CMFCColorPickerCtrl::SetType
表示するカラー ピッカー コントロールの種類を設定します。
void SetType(COLORTYPE colorType);
パラメーター
colorType
[in]カラー ピッカー コントロールの種類。
型は列挙型によって CMFCColorPickerCtrl::COLORTYPE
定義されます。 使用できる型は、輝度、ピッカー、16 進数、HEX_GREYSCALEです。 既定の型は PICKER です。
解説
カラー ピッカー コントロールの種類を指定するには、Windows コントロールを作成する前にこのメソッドを呼び出します。
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示