Fungsi panggilan balik PCMSCALLBACKA (icm.h)
*PCMSCALLBACKA* (atau ApplyCallbackFunction) adalah fungsi panggilan balik yang Anda terapkan yang memperbarui data konfigurasi WCS saat kotak dialog yang ditampilkan oleh fungsi SetupColorMatchingW sedang dijalankan. Nama ApplyCallbackFunction adalah tempat penampung. Nama sebenarnya dari fungsi panggilan balik ini disediakan oleh aplikasi Anda menggunakan ICM.
Sintaks
PCMSCALLBACKA Pcmscallbacka;
BOOL Pcmscallbacka(
_tagCOLORMATCHSETUPA *unnamedParam1,
LPARAM unnamedParam2
)
{...}
Parameter
unnamedParam1
Penunjuk ke struktur COLORMATCHSETUPW yang berisi data konfigurasi WCS.
unnamedParam2
Berisi nilai yang disediakan oleh aplikasi.
Mengembalikan nilai
Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE.
Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE. Fungsi panggilan balik dapat mengatur informasi kesalahan yang diperluas dengan memanggil SetLastError.
Keterangan
Fungsi ApplyCallbackFunction digunakan untuk mengubah konfigurasi WCS untuk perangkat saat kotak dialog Manajemen Warna ditampilkan. Kotak dialog Manajemen Warna ditampilkan oleh fungsi SetupColorMatchingW .
Jika fungsi panggilan balik disediakan, tombol Terapkan ditampilkan di kanan bawah kotak dialog. Saat Anda memilih tombol Terapkan , fungsi panggilan balik segera memperbarui konfigurasi untuk perangkat yang sedang disiapkan. Kotak dialog Manajemen Warna tetap ada di layar.
Aplikasi menyediakan fungsi panggilan balik ke WCS dengan menyimpan alamat fungsi panggilan balik dalam struktur COLORMATCHSETUPW yang diteruskan ke fungsi SetupColorMatchingW . Alamat disimpan di anggota lPfnApplyCallback dari struktur COLORMATCHSETUP . Anggota dwFlags harus diatur ke CMS_USEAPPLYCALLBACK, atau fungsi panggilan balik akan diabaikan.
Nilai yang disediakan oleh aplikasi dapat diteruskan ke fungsi panggilan balik. Sebelum memanggil fungsi SetupColorMatchingW , aplikasi dapat menyimpan nilai di anggota lParamApplyCallback dari struktur COLORMATCHSETUPW . Ketika fungsi panggilan balik dipanggil, nilai dalam anggota struktur lParamApplyCallback akan diteruskan ke fungsi panggilan balik dalam parameter lParam-nya .
Fungsi panggilan balik sepenuhnya opsional. Jika tidak disediakan, tombol Terapkan tidak muncul dalam kotak dialog Manajemen Warna. Microsoft sangat menyarankan agar aplikasi Anda menyediakan fungsi panggilan balik.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | icm.h |