_CPSUICALLBACK fungsi panggilan balik (compstui.h)

Jenis fungsi _CPSUICALLBACK digunakan oleh aplikasi CPSUI (termasuk DLL antarmuka printer) untuk menentukan fungsi panggilan balik yang dimaksudkan untuk digunakan sebagai penangan pesan CPSUI.

Sintaks

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

Parameter

pCPSUICBParam

Pointer yang disediakan CPSUI ke struktur CPSUICBPARAM .

Menampilkan nilai

Fungsi panggilan balik _CPSUICALLBACK-ketik harus mengembalikan salah satu nilai yang tercantum dalam tabel berikut. Setiap nilai menunjukkan tindakan yang harus dilakukan CPSUI.

Menampilkan kode	Deskripsi
CPSUICB_ACTION_ITEMS_APPLIED	Anggota Alasan struktur CPSUICBPARAM diatur ke CPSUICB_REASON_APPLYNOW, dan fungsi panggilan balik telah berhasil memproses nilai opsi saat ini.
CPSUICB_ACTION_NO_APPLY_EXIT	Anggota Alasan struktur CPSUICBPARAM diatur ke CPSUICB_REASON_APPLYNOW, tetapi fungsi panggilan balik telah mendeteksi nilai opsi yang tidak valid atau tidak kompatibel. Fungsi panggilan balik harus menampilkan kotak dialog yang memberi tahu pengguna tentang masalah tersebut.
CPSUICB_ACTION_NONE	Tidak diperlukan tindakan oleh CPSUI.
CPSUICB_ACTION_OPTIF_CHANGED	Fungsi panggilan balik telah mengatur bendera OPTIF_CHANGED dalam struktur OPTITEM untuk menunjukkan bahwa opsi yang dipilih telah berubah, atau bahwa bendera awalan OPTIF lain telah berubah.
CPSUICB_ACTION_REINIT_ITEMS	Fungsi panggilan balik telah mengatur bendera OPTIF_CHANGED dalam struktur OPTITEM untuk menunjukkan bahwa bendera atau anggota pData dari struktur OPTTYPE atau OPTPARAM terkait telah berubah.

Keterangan

Fungsi panggilan balik yang ditentukan menggunakan jenis fungsi _CPSUICALLBACK disediakan oleh aplikasi yang menggunakan CPSUI untuk mengelola halaman lembar properti. Jika salah satu fungsi panggilan balik ini dikaitkan dengan halaman lembar properti, CPSUI memanggilnya saat aktivitas pengguna (seperti mengubah fokus kontrol halaman, memodifikasi nilai opsi, atau mengklik OK) terdeteksi.

Fungsi panggilan balik yang diketik _CPSUICALLBACK ditetapkan ke halaman lembar properti dengan menyertakan alamatnya dalam struktur COMPROPSHEETUI , yang diteruskan ke fungsi ComPropSheet CPSUI saat kode fungsi CPSFUNC_ADD_PCOMPROPSHEETUI.

Selain itu, fungsi panggilan balik dapat ditetapkan ke tombol push yang diperluas melalui penggunaan struktur EXTPUSH .

Ketika salah satu fungsi panggilan balik ini dipanggil, ia menerima penunjuk ke struktur CPSUICBPARAM . Struktur ini menjelaskan pengaturan opsi saat ini untuk halaman dan menunjukkan peristiwa pengguna yang menyebabkan fungsi dipanggil. Fungsi panggilan balik bertanggung jawab untuk memvalidasi dan memproses pengaturan. Ini akan menampilkan kotak dialog jika pengaturan (atau kombinasi pengaturan) tidak valid. Nilai pengembalian fungsi menunjukkan ke CPSUI apakah halaman perlu diputar ulang atau diinisialisasi ulang.

Fungsi panggilan balik yang ditentukan dengan jenis fungsi ini tidak dapat digunakan jika anggota DlgProc dari struktur DLGPAGE menentukan prosedur kotak dialog yang disediakan aplikasi. Ini karena panggilan balik yang diketik _CPSUICALLBACK dipanggil dari prosedur kotak dialog CPSUI, yang tidak digunakan jika aplikasi menyediakan prosedurnya sendiri.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	compstui.h (termasuk Compstui.h)