Struktur CHOOSECOLORA (commdlg.h)

Artikel
03/14/2023

Berisi informasi yang digunakan fungsi ChooseColor untuk menginisialisasi kotak dialog Warna . Setelah pengguna menutup kotak dialog, sistem mengembalikan informasi tentang pilihan pengguna dalam struktur ini.

Sintaks

typedef struct tagCHOOSECOLORA {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HWND         hInstance;
  COLORREF     rgbResult;
  COLORREF     *lpCustColors;
  DWORD        Flags;
  LPARAM       lCustData;
  LPCCHOOKPROC lpfnHook;
  LPCSTR       lpTemplateName;
} CHOOSECOLORA, *LPCHOOSECOLORA;

Anggota

lStructSize

Jenis: DWORD

Panjangnya, dalam byte, dari struktur.

hwndOwner

Jenis: HWND

Handel ke jendela yang memiliki kotak dialog. Anggota ini bisa menjadi handel jendela yang valid, atau bisa NULL jika kotak dialog tidak memiliki pemilik.

hInstance

Jenis: HWND

Jika bendera CC_ENABLETEMPLATEHANDLE diatur di anggota Bendera , hInstance adalah handel ke objek memori yang berisi templat kotak dialog. Jika bendera CC_ENABLETEMPLATE diatur, hInstance adalah handel ke modul yang berisi templat kotak dialog bernama oleh anggota lpTemplateName . Jika tidak CC_ENABLETEMPLATEHANDLE atau CC_ENABLETEMPLATE diatur, anggota ini diabaikan.

rgbResult

Jenis: COLORREF

Jika bendera CC_RGBINIT diatur, rgbResult menentukan warna yang awalnya dipilih saat kotak dialog dibuat. Jika nilai warna yang ditentukan tidak berada di antara warna yang tersedia, sistem memilih warna solid terdekat yang tersedia. Jika rgbResult nol atau CC_RGBINIT tidak diatur, warna yang awalnya dipilih adalah hitam. Jika pengguna mengklik tombol OK , rgbResult menentukan pilihan warna pengguna. Untuk membuat nilai warna COLORREF , gunakan makro RGB .

lpCustColors

Jenis: COLORREF*

Penunjuk ke array 16 nilai yang berisi nilai merah, hijau, biru (RGB) untuk kotak warna kustom dalam kotak dialog. Jika pengguna memodifikasi warna-warna ini, sistem memperbarui array dengan nilai RGB baru. Untuk mempertahankan warna kustom baru antara panggilan ke fungsi ChooseColor , Anda harus mengalokasikan memori statis untuk array. Untuk membuat nilai warna COLORREF , gunakan makro RGB .

Flags

Jenis: DWORD

Sekumpulan bendera bit yang bisa Anda gunakan untuk menginisialisasi kotak dialog Warna . Saat kotak dialog kembali, kotak dialog mengatur bendera ini untuk menunjukkan input pengguna. Anggota ini bisa menjadi kombinasi dari bendera berikut.

Nilai	Makna
CC_ANYCOLOR 0x00000100	Menyebabkan kotak dialog menampilkan semua warna yang tersedia dalam kumpulan warna dasar.
CC_ENABLEHOOK 0x00000010	Mengaktifkan prosedur kait yang ditentukan dalam anggota lpfnHook dari struktur ini. Bendera ini hanya digunakan untuk menginisialisasi kotak dialog.
CC_ENABLETEMPLATE 0x00000020	Anggota hInstance dan lpTemplateName menentukan templat kotak dialog untuk digunakan sebagai pengganti templat default. Bendera ini hanya digunakan untuk menginisialisasi kotak dialog.
CC_ENABLETEMPLATEHANDLE 0x00000040	Anggota hInstance mengidentifikasi blok data yang berisi templat kotak dialog yang dimuat sebelumnya. Sistem mengabaikan anggota lpTemplateName jika bendera ini ditentukan. Bendera ini hanya digunakan untuk menginisialisasi kotak dialog.
CC_FULLOPEN 0x00000002	Menyebabkan kotak dialog menampilkan kontrol tambahan yang memungkinkan pengguna membuat warna kustom. Jika bendera ini tidak diatur, pengguna harus mengklik tombol Tentukan Warna Kustom untuk menampilkan kontrol warna kustom.
CC_PREVENTFULLOPEN 0x00000004	Menonaktifkan tombol Tentukan Warna Kustom .
CC_RGBINIT 0x00000001	Menyebabkan kotak dialog menggunakan warna yang ditentukan dalam anggota rgbResult sebagai pilihan warna awal.
CC_SHOWHELP 0x00000008	Menyebabkan kotak dialog menampilkan tombol Bantuan. Anggota hwndOwner harus menentukan jendela untuk menerima pesan terdaftar HELPMSGSTRING yang dikirim kotak dialog saat pengguna mengklik tombol Bantuan .
CC_SOLIDCOLOR 0x00000080	Menyebabkan kotak dialog hanya menampilkan warna solid dalam kumpulan warna dasar.

lCustData

Jenis: LPARAM

Data yang ditentukan aplikasi yang diteruskan sistem ke prosedur kait yang diidentifikasi oleh anggota lpfnHook . Ketika sistem mengirim pesan WM_INITDIALOG ke prosedur kait, parameter lParam pesan adalah penunjuk ke struktur SELECTCOLOR yang ditentukan saat dialog dibuat. Prosedur kait dapat menggunakan pointer ini untuk mendapatkan nilai lCustData .

lpfnHook

Jenis: LPCCHOOKPROC

Penunjuk ke prosedur hook CCHookProc yang dapat memproses pesan yang ditujukan untuk kotak dialog. Anggota ini diabaikan kecuali bendera CC_ENABLEHOOK diatur dalam anggota Bendera .

lpTemplateName

Jenis: LPCTSTR

Nama sumber daya templat kotak dialog dalam modul yang diidentifikasi oleh anggota hInstance . Templat ini diganti untuk templat kotak dialog standar. Untuk sumber daya kotak dialog bernomor, lpTemplateName bisa menjadi nilai yang dikembalikan oleh makro MAKEINTRESOURCE . Anggota ini diabaikan kecuali bendera CC_ENABLETEMPLATE diatur di anggota Bendera .