Share via

Mengganti halaman Lembar Properti Driver-Supplied

  • Artikel

Penting

Kami menyarankan agar Anda menggunakan driver kelas kotak masuk IPP Microsoft, bersama dengan Print Support Apps (PSA), untuk menyesuaikan pengalaman cetak di Windows 10 dan 11 untuk pengembangan perangkat printer.

Untuk informasi selengkapnya, lihat panduan desain aplikasi dukungan Cetak.

Antarmuka COM IPrintCoreUI2 menyediakan empat metode yang dijalankan plug-in UI Pscript5 pada Windows XP dan versi sistem operasi Windows yang lebih baru harus digunakan ketika berniat untuk sepenuhnya mengganti halaman UI standar driver inti. (Istilah driver inti mengacu pada driver printer Unidrv atau Pscript5.) Metode ini adalah sebagai berikut:

IPrintCoreUI2::EnumConstrainedOptions

IPrintCoreUI2::GetOptions

IPrintCoreUI2::SetOptions

IPrintCoreUI2::WhyConstrained

Metode ini hanya didukung selama eksekusi metode IPrintOemUI::D ocumentPropertySheets plug-in dan IPrintOemUI::D evicePropertySheets dan rutinitas panggilan balik lembar properti mereka. Plug-in UI mendukung metode ini untuk menampilkan antarmuka penggunanya sendiri. Jika tidak didukung, metode ini mengembalikan E_NOTIMPL.

Driver inti menampilkan UI lembar propertinya sendiri dalam dua keadaan--untuk DrvDocumentPropertySheets, dan untuk DrvDevicePropertySheets. Metode pertama menampilkan properti yang hanya berlaku untuk dokumen (properti lengket dokumen), sementara metode kedua menampilkan properti yang berlaku untuk perangkat (properti lengket perangkat atau printer).

Driver inti mengingat jenis lembar properti yang ditanganinya (dan oleh karena itu, mode -- document-sticky atau printer-sticky). Driver inti menyimpan informasi status tersebut dalam struktur (struktur OEMUIOBJ ) yang dibuatnya untuk instans UI. Ketika driver inti memanggil metode antarmuka plug-in, ia meneruskan pointer ke struktur OEMUIOBJ, sehingga ketika plug-in memanggil kembali ke driver inti dari IPrintCoreUI2::EnumConstrainedOptions, IPrintCoreUI2::GetOptions, IPrintCoreUI2::SetOptions, atau IPrintCoreUI2::WhyConstrained, metode ini meneruskan pointer kembali ke driver inti, yang kemudian dapat menentukan mode.

Untuk IPrintCoreUI2::EnumConstrainedOptions, IPrintCoreUI2::SetOptions, dan IPrintCoreUI2::WhyConstrained, hanya fitur lengket dokumen yang didukung selama eksekusi IPrintOemUI::D ocumentPropertySheets atau rutinitas panggilan balik lembar propertinya dan hanya fitur lengket printer yang didukung selama eksekusi IPrintOemUI::D evicePropertySheets atau rutinitas panggilan balik lembar propertinya. Untuk IPrintCoreUI2::SetOptions, fitur apa pun yang kelekatannya tidak cocok dengan mode lengket saat ini harus diabaikan. Ketika IPrintCoreUI2::EnumConstrainedOptions atau IPrintCoreUI2::WhyConstrained dipanggil untuk fitur yang kelekatannya tidak cocok dengan mode lengket saat ini, metode harus mengembalikan E_INVALIDARG.

Untuk IPrintCoreUI2::GetOptions, fitur lengket dokumen dan lengket printer didukung dalam mode lengket dokumen (yaitu, ketika IPrintOemUI::D ocumentPropertySheets atau rutinitas panggilan balik lembar propertinya berjalan), tetapi hanya fitur lengket printer yang didukung dalam mode lengket printer (ketika IPrintOemUI::D evicePropertySheets atau rutinitas panggilan balik lembar propertinya berjalan).