Kelas CMFCColorPickerCtrl

Kelas ini CMFCColorPickerCtrl menyediakan fungsionalitas untuk kontrol yang digunakan untuk memilih warna.

Sintaks

class CMFCColorPickerCtrl : public CButton

Anggota

Konstruktor Publik

Nama	Deskripsi
CMFCColorPickerCtrl::CMFCColorPickerCtrl	Membuat CMFCColorPickerCtrl objek.

Metode Publik

Nama	Deskripsi
CMFCColorPickerCtrl::GetColor	Mengambil warna yang dipilih pengguna.
CMFCColorPickerCtrl::GetHLS	Mengambil nilai hue, luminance, dan saturasi warna yang dipilih pengguna.
CMFCColorPickerCtrl::GetHue	Mengambil komponen warna warna yang dipilih pengguna.
CMFCColorPickerCtrl::GetLuminance	Mengambil komponen luminance warna yang dipilih pengguna.
CMFCColorPickerCtrl::GetSaturation	Mengambil komponen saturasi warna yang dipilih pengguna.
CMFCColorPickerCtrl::SelectCellHexagon	Mengatur warna saat ini ke warna yang ditentukan oleh komponen warna RGB yang ditentukan atau segi enam sel yang ditentukan.
CMFCColorPickerCtrl::SetColor	Mengatur warna saat ini ke nilai warna RGB yang ditentukan.
CMFCColorPickerCtrl::SetHLS	Mengatur warna saat ini ke nilai warna HLS yang ditentukan.
CMFCColorPickerCtrl::SetHue	Mengubah komponen hue dari warna yang saat ini dipilih.
CMFCColorPickerCtrl::SetLuminance	Mengubah komponen luminance dari warna yang saat ini dipilih.
CMFCColorPickerCtrl::SetLuminanceBarWidth	Mengatur lebar bilah luminance di kontrol pemilih warna.
CMFCColorPickerCtrl::SetOriginalColor	Menyetel warna awal terpilih.
CMFCColorPickerCtrl::SetPalette	Mengatur palet warna saat ini.
CMFCColorPickerCtrl::SetSaturation	Mengubah komponen saturasi dari warna yang saat ini dipilih.
CMFCColorPickerCtrl::SetType	Mengatur tipe kontrol pemilih warna untuk ditampilkan.

Metode yang Dilindungi

Nama	Deskripsi
CMFCColorPickerCtrl::DrawCursor	Dipanggil oleh kerangka kerja sebelum kursor yang menunjuk ke warna yang dipilih ditampilkan.

Keterangan

Warna standar dipilih dari palet warna heksagonal, dan warna kustom dipilih dari bilah luminance di mana warna ditentukan menggunakan notasi merah/hijau/biru atau notasi hue/saturation/luminance.

Ilustrasi berikut menggambarkan beberapa CMFCColorPickerCtrl objek.

Mendukung CMFCColorPickerCtrl dua pasang gaya. Gaya HEX dan HEX_GREYSCALE sesuai untuk pemilihan warna standar. Gaya PICKER dan LUMINANCE sesuai untuk pilihan warna kustom.

Lakukan langkah-langkah berikut untuk menggabungkan kontrol ke CMFCColorPickerCtrl dalam kotak dialog Anda:

1. Jika Anda menggunakan ClassWizard, sisipkan kontrol tombol baru ke templat kotak dialog Anda (karena CMFCColorPickerCtrl kelas diwariskan dari CButton kelas ).

2. Sisipkan variabel anggota yang terkait dengan kontrol tombol baru ke dalam kelas kotak dialog Anda. Kemudian ubah jenis variabel dari CButton ke CMFCColorPickerCtrl.

3. Sisipkan handler WM_INITDIALOG pesan untuk kelas kotak dialog. Di handler, atur jenis, palet, dan warna CMFCColorPickerCtrl awal kontrol yang dipilih.

Hierarki Warisan

CObject
CCmdTarget
CWnd
CButton
CMFCColorPickerCtrl

Persyaratan

Header: afxcolorpickerctrl.h

CMFCColorPickerCtrl::CMFCColorPickerCtrl

Membuat CMFCColorPickerCtrl objek.

CMFCColorPickerCtrl();

Tampilkan Nilai

Keterangan

CMFCColorPickerCtrl::DrawCursor

Dipanggil oleh kerangka kerja sebelum kursor yang menunjuk ke warna yang dipilih ditampilkan.

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

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rect
[di] Menentukan area persegi panjang di sekitar warna terpilih.

Keterangan

Ambil alih metode ini ketika Anda perlu mengubah bentuk kursor yang menunjuk ke warna yang dipilih.

CMFCColorPickerCtrl::GetColor

Mengambil warna yang dipilih pengguna.

COLORREF GetColor() const;

Tampilkan Nilai

Nilai RGB dari warna yang dipilih.

Keterangan

CMFCColorPickerCtrl::GetHLS

Mengambil nilai hue, luminance, dan saturasi warna yang dipilih pengguna.

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

Parameter

hue
[out] Pointer ke variabel jenis ganda yang menerima informasi hue.

luminance
[out] Penunjuk ke variabel jenis ganda yang menerima informasi luminance.

saturation
[out] Penunjuk ke variabel jenis ganda yang menerima informasi saturasi.

Keterangan

CMFCColorPickerCtrl::GetHue

Mengambil komponen warna warna yang dipilih pengguna.

double GetHue() const;

Tampilkan Nilai

Komponen rona dari warna yang dipilih.

Keterangan

CMFCColorPickerCtrl::GetLuminance

Mengambil komponen luminance warna yang dipilih pengguna.

double GetLuminance() const;

Tampilkan Nilai

Komponen luminance dari warna yang dipilih.

Keterangan

CMFCColorPickerCtrl::GetSaturation

Mengambil nilai saturasi warna yang dipilih pengguna.

double GetSaturation() const;

Tampilkan Nilai

Komponen saturasi dari warna terpilih.

Keterangan

CMFCColorPickerCtrl::SelectCellHexagon

Mengatur warna saat ini ke warna yang ditentukan oleh komponen warna RGB yang ditentukan atau segi enam sel yang ditentukan.

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

BOOL SelectCellHexagon(
    int x,
    int y);

Parameter

R
[di] Komponen warna merah.

G
[di] Komponen warna hijau.

B
[di] Komponen warna biru.

x
[di] Koordinat x kursor, yang menunjuk ke segi enam sel.

y
[di] Koordinat y kursor, yang menunjuk ke segi enam sel.

Tampilkan Nilai

Kelebihan kedua dari metode ini selalu mengembalikan FALSE.

Keterangan

Kelebihan beban pertama dari metode ini mengatur warna saat ini ke warna yang sesuai dengan komponen warna merah, hijau, dan biru kontrol pilihan warna yang ditentukan.

Kelebihan beban kedua dari metode ini mengatur warna saat ini ke warna segi enam sel yang ditujukkan oleh lokasi kursor yang ditentukan.

CMFCColorPickerCtrl::SetColor

Mengatur warna saat ini ke nilai warna RGB yang ditentukan.

void SetColor(COLORREF Color);

Parameter

Color
[di] Nilai warna RGB.

Keterangan

CMFCColorPickerCtrl::SetHLS

Mengatur warna saat ini ke nilai warna HLS yang ditentukan.

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

Parameter

hue
[di] Nilai rona.

luminance
[di] Nilai luminance.

saturation
[di] Nilai saturasi.

bInvalidate
[di] TRUE untuk memaksa jendela untuk segera memperbarui ke warna baru; jika tidak, FALSE. Default adalah TRUE.

Keterangan

CMFCColorPickerCtrl::SetHue

Mengubah warna warna yang saat ini dipilih.

void SetHue(double Hue);

Parameter

Hue
[di] Nilai rona.

Keterangan

CMFCColorPickerCtrl::SetLuminance

Mengubah luminasi warna yang saat ini dipilih.

void SetLuminance(double Luminance);

Parameter

Luminance
[di] Nilai luminance.

Keterangan

CMFCColorPickerCtrl::SetLuminanceBarWidth

Mengatur lebar bilah luminance di kontrol pemilih warna.

void SetLuminanceBarWidth(int w);

Parameter

w
[di] Lebar bilah luminance yang diukur dalam piksel.

Keterangan

Gunakan metode ini untuk mengubah ukuran bilah luminance, yang ada di tab Kustom kontrol pemilih warna. Parameter w menentukan lebar baru bilah luminance. Nilai lebar diabaikan jika melebihi tiga perempat dari lebar area klien.

CMFCColorPickerCtrl::SetOriginalColor

Menyetel warna awal terpilih.

void SetOriginalColor(COLORREF ref);

Parameter

ref
[di] Nilai warna RGB.

Keterangan

Panggil metode ini ketika kontrol pemilih warna diinisialisasi.

CMFCColorPickerCtrl::SetPalette

Mengatur palet warna saat ini.

void SetPalette(CPalette* pPalette);

Parameter

pPalette
[di] Penunjuk ke palet warna.

Keterangan

Palet warna menentukan array warna yang disajikan dalam kontrol pemilih warna.

CMFCColorPickerCtrl::SetSaturation

Mengubah saturasi warna yang saat ini dipilih.

void SetSaturation(double Saturation);

Parameter

Saturation
[in] Nilai saturasi.

Keterangan

CMFCColorPickerCtrl::SetType

Mengatur tipe kontrol pemilih warna untuk ditampilkan.

void SetType(COLORTYPE colorType);

Parameter

colorType
[di] Jenis kontrol pemilih warna.

Jenis didefinisikan oleh CMFCColorPickerCtrl::COLORTYPE enumerasi. Jenis yang mungkin adalah LUMINANCE, , HEX PICKERdan HEX_GREYSCALE. Jenis defaultnya adalah PICKER.

Keterangan

Untuk menentukan tipe kontrol pemilih warna, panggil metode ini sebelum kontrol Windows dibuat.

Lihat juga

Bagan Hierarki
Kelas
CMFCColorDialog Kelas