Fungsi panggilan balik PFNPROPSHEETUI (compstui.h)

Artikel
03/08/2023

Jenis fungsi PFNPROPSHEETUI digunakan oleh aplikasi CPSUI (termasuk DLL antarmuka printer) untuk menentukan panggilan balik pembuatan halaman, yang menentukan halaman lembar properti untuk dibuat.

Sintaks

PFNPROPSHEETUI Pfnpropsheetui;

LONG Pfnpropsheetui(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM lParam
)
{...}

Parameter

pPSUIInfo

Pointer yang disediakan CPSUI ke struktur PROPSHEETUI_INFO .

lParam

Nilai bilangan bulat yang disediakan CPSUI yang bergantung pada konten anggota Alasan dari struktur PROPSHEETUI_INFO . Nilai yang valid adalah sebagai berikut:

PROPSHEETUI_REASON_BEFORE_INIT

Nilai ini baru Windows 8 dan hanya disediakan untuk parameter PFNPROPSHEETUI asli yang diteruskan ke CommonPropertySheetUI.

PROPSHEETUI_REASON_DESTROY

Nilai lParam bukan nol jika pengguna telah memilih tombol OK atau Batalkan lembar properti. Jika tidak, nilainya adalah nol.

PROPSHEETUI_REASON_GET_ICON

Nilai lParam adalah penunjuk ke struktur PROPSHEETUI_GETICON_INFO .

PROPSHEETUI_REASON_GET_INFO_HEADER

Nilai lParam adalah penunjuk ke struktur PROPSHEETUI_INFO_HEADER .

PROPSHEETUI_REASON_INIT

Jika fungsi panggilan balik ditentukan oleh parameter pfnPropSheetUI ke CommonPropertySheetUI, lParam adalah nilai lParam yang diteruskan ke CommonPropertySheetUI.

Jika fungsi panggilan balik ditentukan menggunakan kode fungsi CPSFUNC_ADD_PFNPROPSHEETUI dengan fungsi ComPropSheet CPSUI, lParam adalah nilai lParam2 yang diteruskan ke ComPropSheet.

CPSUI menyalin nilai lParam ke anggota lParamInit dari struktur PROPSHEETUI_INFO fungsi.

Nilai lParam tidak boleh berada di tumpukan aplikasi.

PROPSHEETUI_REASON_SET_RESULT

Nilai lParam adalah penunjuk ke struktur SETRESULT_INFO .

Menampilkan nilai

Jika operasi berhasil, fungsi harus mengembalikan nilai satu (atau lebih besar). Jika tidak, nilai harus dikembalikan kurang dari satu.

Menampilkan kode	Deskripsi
Satu atau lebih besar.	Fungsi PFNPROPSHEETUI yang terkait dengan induk halaman saat ini akan dipanggil.
Kurang dari 1.	Fungsi PFNPROPSHEETUI yang terkait dengan induk halaman saat ini tidak akan dipanggil.

Keterangan

Fungsi panggilan balik yang ditentukan menggunakan jenis fungsi PFNPROPSHEETUI disediakan oleh aplikasi yang menggunakan CPSUI untuk mengelola halaman lembar properti yang disesuaikan. Salah satu fungsi panggilan balik tersebut harus ditentukan ketika aplikasi memanggil fungsi CommonPropertySheetUI . Misalnya, ketika penampung cetak sistem operasi berbasis NT memanggil fungsi CommonPropertySheetUI CPSUI untuk mendukung fungsi DocumentProperties atau PrinterProperties , penampung menentukan fungsi panggilan balik internal yang diketik PFNPROPSHEETUI.

Aplikasi dapat menentukan fungsi panggilan balik tambahan yang diketik PFNPROPSHEETUI dengan memanggil fungsi ComPropSheet CPSUI dengan kode fungsi CPSFUNC_ADD_PFNPROPSHEETUI. Misalnya, penampung cetak sistem operasi berbasis NT melakukan ini untuk memberi tahu CPSUI tentang keberadaan fungsi DrvDocumentPropertySheets dan DrvDevicePropertySheets antarmuka printer. Demikian juga, driver Unidrv dan Pscript Microsoft menggunakan teknik ini untuk memberi tahu CPSUI tentang keberadaan metode IPrintOemUI::D ocumentPropertySheets dan IPrintOemUI::D evicePropertySheets dalam plug-in antarmuka pengguna.

Setiap fungsi panggilan balik yang diketik PFNPROPSHEETUI dipanggil oleh CPSUI beberapa kali. Anggota Alasan struktur PROPSHEETUI_INFO menetapkan operasi yang harus dilakukan fungsi, sebagai berikut:

Persyaratan

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

Bagikan melalui