Fungsi panggilan balik OEMCUIPCALLBACK (printoem.h)

Artikel
02/29/2024

Jenis fungsi OEMCUIPCALLBACK digunakan untuk menentukan fungsi panggilan balik yang ditentukan oleh metode IPrintOemUI::CommonUIProp antarmuka pengguna. Struktur didefinisikan dalam printoem.h.

Sintaks

OEMCUIPCALLBACK Oemcuipcallback;

LONG Oemcuipcallback(
  PCPSUICBPARAM unnamedParam1,
  POEMCUIPPARAM unnamedParam2
)
{...}

Parameter

unnamedParam1

Penunjuk ke struktur CPSUICBPARAM .

unnamedParam2

Penunjuk ke struktur OEMCUIPPARAM .

Nilai kembali

Lihat bagian Keterangan berikut.

Keterangan

Fungsi panggilan balik yang ditentukan oleh metode IPrintOemUI::CommonUIProp dipanggil saat pengguna memodifikasi lembar properti printer. Tujuan fungsi panggilan balik adalah untuk memproses modifikasi pengguna pada item opsi yang disesuaikan.

Ketika item lembar properti dimodifikasi, CPSUI memanggil DLL antarmuka printer pengandar pencetak. DLL ini berisi fungsi panggilan baliknya sendiri, dari jenis _CPSUICALLBACK, yang memproses nilai opsi yang terkandung dalam struktur OPTITEM sendiri. Kemudian fungsi panggilan balik DLL antarmuka printer memanggil fungsi panggilan balik plug-in antarmuka pengguna. Jika beberapa plug-in antarmuka pengguna disediakan, setiap fungsi panggilan balik plug-in dipanggil, pada gilirannya, dalam urutan pemasangan plug-in.

Fungsi panggilan balik menerima penunjuk ke struktur CPSUICBPARAM . Anggota Alasan struktur mengidentifikasi peristiwa yang menyebabkan fungsi panggilan balik dipanggil. Fungsi ini juga menerima penunjuk ke struktur OEMCUIPPARAM yang sama yang digunakan ketika metode IPrintOemUI::CommonUIProp menentukan alamat fungsi panggilan balik.

Anggota pOptItem dan pCurItem struktur CPSUICBPARAM mengidentifikasi opsi yang dimodifikasi. Fungsi panggilan balik dapat menggunakan pointer ini, bersama dengan anggota pOEMOptItems dan cOEMOptItem dari struktur OEMCUIPPARAM, untuk menentukan apakah opsi yang dimodifikasi adalah yang dimiliki oleh plug-in antarmuka pengguna.

Ketika fungsi panggilan balik dipanggil, fungsi tersebut harus menentukan apakah salah satu struktur OPTITEM yang disesuaikan dipengaruhi oleh nilai Alasan yang ditentukan. Jika ya, fungsi harus memproses opsi yang terpengaruh dan mengembalikan salah satu nilai pengembalian yang diawali CPSUI_ACTION yang dijelaskan untuk jenis fungsi _CPSUICALLBACK . Jika tidak, itu harus mengembalikan CPSUICB_ACTION_NONE.

Aturan tambahan berikut berlaku untuk nilai pengembalian fungsi panggilan balik:

Jika Alasan berisi CPSUICB_REASON_APPLYNOW, panggilan balik harus mengembalikan CPSUICB_ACTION_ITEMS_APPLIED atau CPSUICB_ACTION_NO_APPLY_EXIT. Dalam kasus terakhir, antarmuka driver printer segera kembali ke CPSUI tanpa memanggil fungsi panggilan balik plug-in antarmuka pengguna lainnya.
Jika Alasan berisi nilai apa pun kecuali CPSUICB_REASON_APPLYNOW, maka nilai yang dikembalikan harus salah satu dari yang berikut ini:
- CPSUICB_ACTION_REINIT_ITEMS
- CPSUICB_ACTION_OPTIF_CHANGED
- CPSUICB_ACTION_NONE
  
  Nilai yang dikembalikan ini tercantum dalam urutan penurunan prioritas. Jika ada beberapa plug-in antarmuka pengguna, DLL antarmuka printer memanggil fungsi panggilan balik masing-masing dan menyimpan nilai pengembalian prioritas tertinggi, meneruskannya kembali ke CPSUI.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	printoem.h (termasuk Printoem.h, Compstui.h)

Bagikan melalui