Struktur COLORMATCHSETUPA (icm.h)
Struktur COLORMATCHSETUP berisi informasi yang digunakan fungsi SetupColorMatchingW untuk menginisialisasi kotak dialog ColorManagement . Setelah pengguna menutup kotak dialog, SetupColorMatching mengembalikan informasi tentang pilihan pengguna dalam struktur ini.
Sintaks
typedef struct _tagCOLORMATCHSETUPA {
DWORD dwSize;
DWORD dwVersion;
DWORD dwFlags;
HWND hwndOwner;
PCSTR pSourceName;
PCSTR pDisplayName;
PCSTR pPrinterName;
DWORD dwRenderIntent;
DWORD dwProofingIntent;
PSTR pMonitorProfile;
DWORD ccMonitorProfile;
PSTR pPrinterProfile;
DWORD ccPrinterProfile;
PSTR pTargetProfile;
DWORD ccTargetProfile;
DLGPROC lpfnHook;
LPARAM lParam;
PCMSCALLBACKA lpfnApplyCallback;
LPARAM lParamApplyCallback;
} COLORMATCHSETUPA, *PCOLORMATCHSETUPA, *LPCOLORMATCHSETUPA;
Anggota
dwSize
Ukuran struktur. Harus diatur ke sizeof ( COLORMATCHSETUP ).
dwVersion
Versi struktur COLORMATCHSETUP . Ini harus diatur ke COLOR_MATCH_VERSION.
dwFlags
Sekumpulan bendera bit yang digunakan untuk menginisialisasi kotak dialog. Jika diatur ke 0 pada entri, semua kontrol mengasumsikan status defaultnya.
Saat kotak dialog kembali, bendera ini diatur untuk menunjukkan input pengguna.
Anggota ini dapat diatur menggunakan kombinasi bendera berikut.
| Bendera | Makna |
|---|---|
| CMS_DISABLEICM | Jika diatur pada entri, bendera ini menunjukkan bahwa kotak centang "Aktifkan Manajemen Warna" dikosongkan, menonaktifkan semua kontrol lainnya. Jika diatur saat keluar, itu berarti bahwa pengguna tidak ingin manajemen warna dilakukan. |
| CMS_ENABLEPROOFING | Jika diatur pada entri, bendera ini menunjukkan bahwa kontrol Pemeriksaan akan diaktifkan, dan kotak centang Pemeriksaan dicentang. Jika diatur saat keluar, itu berarti bahwa pengguna ingin melakukan manajemen warna untuk perangkat target yang berbeda dari printer yang dipilih. |
| CMS_SETRENDERINTENT | Jika diatur pada entri, bendera ini menunjukkan bahwa anggota dwRenderIntent berisi nilai yang akan digunakan untuk menginisialisasi kontrol Niat Penyajian. Jika tidak, kontrol default ke Penyajian gambar. Bendera ini diatur saat keluar jika WCS diaktifkan. |
| CMS_SETPROOFINTENT | Diabaikan kecuali CMS_ENABLEPROOFING juga diatur. Jika diatur pada entri, dan CMS_ENABLEPROOFING juga diatur, bendera ini menunjukkan bahwa anggota dwProofingIntent akan digunakan untuk menginisialisasi kontrol Niat Penyajian Target. Jika tidak, kontrol default ke Penyajian gambar. Bendera ini diatur saat keluar jika pemeriksaan diaktifkan. |
| CMS_SETMONITORPROFILE | Jika diatur pada entri, bendera ini menunjukkan bahwa profil manajemen warna bernama dalam anggota pMonitorProfile adalah menjadi pilihan awal dalam kontrol profil monitor. Jika profil yang ditentukan tidak terkait dengan monitor, bendera ini diabaikan, dan profil default untuk monitor digunakan. |
| CMS_SETPRINTERPROFILE | Jika diatur pada entri, bendera ini menunjukkan bahwa profil manajemen warna yang dinamai dalam anggota pPrinterProfile adalah menjadi pilihan awal dalam kontrol profil printer. Jika profil yang ditentukan tidak terkait dengan pencetak, bendera ini diabaikan, dan profil default untuk pencetak digunakan. |
| CMS_SETTARGETPROFILE | Jika diatur pada entri, bendera ini menunjukkan bahwa profil warna yang dinamai dalam anggota pTargetProfile adalah menjadi pilihan awal dalam kontrol profil target. Jika profil yang ditentukan tidak diinstal, bendera ini diabaikan, dan profil default untuk printer digunakan. Jika printer tidak memiliki profil default, profil pertama dalam urutan alfabet akan ditampilkan. |
| CMS_USEHOOK | Bendera ini menentukan bahwa anggota lpfnHook berisi alamat prosedur kait, dan anggota lParam berisi nilai yang akan diteruskan ke prosedur hook ketika pesan WM_INITDIALOG dikirim. |
| CMS_MONITOROVERFLOW | Bendera ini diatur saat keluar jika manajemen warna akan diaktifkan dan ukuran buffer yang diberikan di ccMonitorProfile tidak cukup untuk nama profil yang dipilih. GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER dalam kasus seperti itu. |
| CMS_PRINTERROVERFLOW | Bendera ini diatur saat keluar jika manajemen warna akan diaktifkan dan ukuran buffer yang diberikan dalam ccPrinterProfile tidak cukup untuk nama profil yang dipilih. GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER dalam kasus seperti itu. |
| CMS_TARGETOVERFLOW | Bendera ini diatur saat keluar jika pemeriksaan akan diaktifkan dan ukuran buffer yang diberikan di ccTargetProfile tidak cukup untuk nama profil yang dipilih. GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER dalam kasus seperti itu. |
| CMS_USEAPPLYCALLBACK | Jika diatur pada entri, bendera ini menunjukkan bahwa fungsi SetupColorMatching harus memanggil fungsi PCMSCALLBACKW. Alamat fungsi panggilan balik terkandung dalam lpfnApplyCallback. |
| CMS_USEDESCRIPTION | Jika diatur pada entri, bendera ini menginstruksikan fungsi SetupColorMatching untuk mengambil deskripsi profil yang terkandung dalam tag deskripsi profil (Lihat Spesifikasi Format Profil ICC v3.4). Ini akan memasukkannya ke dalam kotak edit Profil Monitor, Profil Printer, Profil Perangkat Yang Ditimulasi dalam kotak dialog umum Manajemen Warna . |
hwndOwner
Handel jendela kepada pemilik kotak dialog, atau NULL jika kotak dialog tidak memiliki pemilik.
pSourceName
Penunjuk ke string yang ditentukan aplikasi yang menjelaskan profil sumber item yang manajemen warnanya akan dilakukan. Jika ini NULL, kontrol Sumber Gambar menampilkan nama profil warna default Windows.
pDisplayName
Menunjuk ke string yang memberi nama monitor yang akan digunakan untuk manajemen warna. Jika ini bukan nama monitor yang valid, monitor enumerasi pertama akan digunakan.
pPrinterName
Menunjuk ke string yang memberi nama printer tempat gambar akan dirender. Jika ini bukan nama printer yang valid, printer default digunakan dan dinamai dalam dialog.
dwRenderIntent
Jenis manajemen warna yang diinginkan. Nilai yang valid adalah:
INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
Untuk informasi selengkapnya, lihat Niat rendering.
dwProofingIntent
Jenis manajemen warna yang diinginkan untuk gambar yang di-proof. Nilai yang valid adalah:
INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
Untuk informasi selengkapnya, lihat Niat rendering.
pMonitorProfile
Arahkan ke buffer untuk menempatkan nama profil monitor yang dipilih pengguna. Jika bendera CMS_SETMONITORPROFILE digunakan, bendera ini juga dapat digunakan untuk memilih profil selain default monitor saat dialog pertama kali ditampilkan.
ccMonitorProfile
Ukuran buffer yang ditunjukkan oleh anggota pMonitorProfile , dalam karakter. Jika buffer tidak cukup besar untuk menahan nama yang dipilih, nama dipotong ke ukuran ini, dan ERROR_INSUFFICIENT_BUFFER dikembalikan. Buffer dengan ukuran MAX_PATH selalu berfungsi.
pPrinterProfile
Menunjuk ke buffer untuk menempatkan nama profil printer yang dipilih pengguna. Jika bendera CMS_SETPRINTERPROFILE digunakan, bendera ini juga dapat digunakan untuk memilih profil selain default printer saat dialog pertama kali ditampilkan.
ccPrinterProfile
Ukuran buffer yang ditujukkan oleh anggota pPrinterProfile , dalam karakter. Jika buffer tidak cukup besar untuk menahan nama yang dipilih, nama dipotong ke ukuran ini, dan ERROR_INSUFFICIENT_BUFFER dikembalikan. Buffer dengan ukuran MAX_PATH selalu berfungsi.
pTargetProfile
Menunjuk ke buffer untuk menempatkan nama profil target yang dipilih pengguna untuk pemeriksaan. Jika bendera CMS_SETTARGETPROFILE digunakan, bendera ini juga dapat digunakan untuk memilih profil selain default printer saat dialog pertama kali ditampilkan.
ccTargetProfile
Ukuran buffer yang ditujukkan oleh anggota pTargetProfile , dalam karakter. Jika buffer tidak cukup besar untuk menahan nama yang dipilih, nama dipotong ke ukuran ini, dan ERROR_INSUFFICIENT_BUFFER dikembalikan. Buffer dengan ukuran MAX_PATH selalu berfungsi.
lpfnHook
Jika bendera CMS_USEHOOK diatur, anggota ini adalah alamat prosedur dialog (lihat DialogProc ) yang dapat memfilter atau menangani pesan untuk dialog. Prosedur kait tidak menerima pesan yang dikeluarkan sebelum WM_INITDIALOG. Ini dipanggil pada pesan WM_INITDIALOG setelah prosedur dialog yang disediakan sistem telah memproses pesan. Pada semua pesan lain, prosedur kait menerima pesan sebelum prosedur yang disediakan sistem. Jika prosedur kait mengembalikan TRUE ke pesan-pesan ini, prosedur yang disediakan sistem tidak dipanggil.
Prosedur kait dapat memanggil fungsi EndDialog .
lParam
Jika bendera CMS_USEHOOK diatur, anggota ini diteruskan ke prosedur kait yang disediakan aplikasi sebagai parameter lParam saat pesan WM_INITDIALOG diproses.
lpfnApplyCallback
Berisi penunjuk ke fungsi panggilan balik yang dipanggil saat tombol Terapkan dari kotak dialog Manajemen Warna dipilih. Jika tidak ada fungsi panggilan balik yang disediakan, anggota ini harus diatur ke NULL. Lihat PCMSCALLBACKW.
lParamApplyCallback
Berisi nilai yang akan diteruskan ke fungsi ApplyCallbackFunction melalui parameter lParam-nya . Arti dan konten nilai ditentukan oleh aplikasi.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | icm.h |