Metode IPrintOemUI::D ocumentPropertySheets (prcomoem.h)

Artikel
08/07/2023

Metode ini IPrintOemUI::DocumentPropertySheets memungkinkan plug-in antarmuka pengguna untuk menambahkan halaman baru ke lembar properti dokumen perangkat printer.

Sintaks

HRESULT DocumentPropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

Parameter

pPSUIInfo

Penunjuk yang disediakan penelepon ke struktur PROPSHEETUI_INFO .

lParam

Nilai yang disediakan penelepon yang bergantung pada nilai alasan dalam pPSUIInfo-->Reason. Nilai alasannya bisa menjadi salah satu konstanta berikut, yang didefinisikan dalam compstui.h. Untuk informasi selengkapnya tentang konstanta ini, lihat bagian Keterangan dan deskripsi parameter lParam dalam jenis fungsi PFNPROPSHEETUI .

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

Nilai kembali

Nilai yang dikembalikan tergantung pada konten anggota Alasan struktur PROPSHEETUI_INFO. Untuk informasi selengkapnya, lihat deskripsi DrvDocumentPropertySheets.

Keterangan

Metode plug-in antarmuka pengguna melakukan jenis operasi yang sama dengan fungsi DrvDocumentPropertySheets yang diekspor IPrintOemUI::DocumentPropertySheets oleh DLL antarmuka printer mode pengguna. Kedua fungsi memiliki parameter input yang sama.

Jika Anda menyediakan plug-in antarmuka pengguna, IPrintOemUI::DocumentPropertySheets metode ini dipanggil setelah fungsi DrvDocumentPropertySheets driver dipanggil.

Ketika IPrintOemUI::DocumentPropertySheets dipanggil, anggota lParamInit dari struktur PROPSHEETUI_INFO berisi alamat struktur OEMUIPSPARAM .

Jika Anda menerapkan metode ini, Anda biasanya juga menyediakan fungsi panggilan balik _CPSUICALLBACK-ketik untuk menangani modifikasi pengguna. Fungsi panggilan balik ini harus memanggil IPrintOemDriverUI::D rvUpdateUISetting untuk memberi tahu driver ketika nilai yang terkait dengan pengaturan antarmuka pengguna telah dimodifikasi, jika nilai disimpan dalam struktur DEVMODEW driver (bukan anggota DEVMODEW privat plug-in ) atau dalam kunci registri.

Jika IPrintOemUI::DocumentPropertySheets metode diekspor oleh beberapa plug-in antarmuka pengguna, metode dipanggil dalam urutan plug-in ditentukan untuk penginstalan.

Jika satu plug-in antarmuka pengguna mendukung beberapa model printer, dan jika Anda hanya ingin halaman baru ditampilkan untuk beberapa model tersebut IPrintOemUI::DocumentPropertySheets , metode seharusnya hanya memberikan nilai pengembalian keberhasilan, tanpa benar-benar menambahkan halaman, untuk model yang tidak memerlukan halaman.

Untuk informasi selengkapnya tentang membuat dan menginstal plug-in antarmuka pengguna, lihat Menyesuaikan Driver Printer Microsoft.