Fungsi DrvDocumentPropertySheets (winddiui.h)
Fungsi DrvDocumentPropertySheets antarmuka printer DLL bertanggung jawab untuk membuat halaman lembar properti yang menjelaskan properti dokumen cetak.
Sintaks
LONG DrvDocumentPropertySheets(
[in, optional] PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam
);
Parameter
[in, optional] pPSUIInfo
Penunjuk yang disediakan penelepon ke struktur PROPSHEETUI_INFO . Bisa NULL (lihat bagian Keterangan berikut).
lParam
Nilai bilangan bulat yang disediakan penelepon yang bergantung pada konten anggota Alasan struktur PROPSHEETUI_INFO, seperti yang tercantum dalam tabel berikut.
Nilai alasan | Definisi lParam |
---|---|
PROPSHEETUI_REASON_INIT | Penunjuk ke struktur DOCUMENTPROPERTYHEADER . |
Semua nilai alasan lainnya | Lihat deskripsi parameter lParam untuk jenis fungsi PFNPROPSHEETUI . (Alamat struktur DOCUMENTPROPERTYHEADER terkandung dalam anggota lParamInit dari struktur PROPSHEETUI_INFO .) |
Nilai kembali
Jika pPSUIInfoADALAH NULL, dan jika lParam ->fMode nol atau lParam ->pdmOutadalah NULL, fungsi ini harus mengembalikan ukuran, dalam byte, dari struktur DEVMODEW printer. Jika tidak, nilai pengembalian fungsi sama dengan yang dijelaskan di bagian ReturnValue dari jenis fungsi PFNPROPSHEETUI . Untuk informasi selengkapnya, lihat bagian Keterangan.
Keterangan
Semua DLL antarmuka printer harus menyediakan fungsi DrvDocumentPropertySheets , yang didefinisikan menggunakan jenis fungsi PFNPROPSHEETUI . Tujuan fungsi ini adalah untuk memanggil fungsi ComPropSheet , yang disediakan oleh CPSUI, untuk menentukan halaman lembar properti yang berisi properti yang dapat dimodifikasi pengguna untuk mencetak dokumen.
Jika nilai yang diterima untuk parameter pPSUIInfo bukan NULL, penampung cetak sistem operasi berbasis NT memanggil fungsi secara tidak langsung, melalui CPSUI. Aturan berikut ini akan berlaku:
Fungsi harus melakukan operasi seperti yang dijelaskan untuk jenis fungsi PFNPROPSHEETUI .
Bendera di anggota fMode struktur DOCUMENTPROPERTYHEADER menunjukkan halaman lembar properti mana yang akan ditampilkan dan apakah pengguna harus diizinkan untuk mengubah properti dokumen. Satu-satunya bendera yang mungkin diatur adalah DM_IN_PROMPT (atau DM_PROMPT), DM_ADVANCED, DM_NOPERMISSION, dan DM_OUT_BUFFER (atau DM_COPY).
Jika nilai yang diterima untuk parameter pPSUIInfo adalah NULL, penampung cetak memanggil fungsi secara langsung, tanpa melalui CPSUI. Dalam hal ini, parameter lParam berisi alamat struktur DOCUMENTPROPERTYHEADER, dan aturan berikut berlaku:
Jika anggota fMode dari struktur DOCUMENTPROPERTYHEADER adalah nol, atau jika anggota pdmOut dari struktur yang sama adalah NULL, fungsi harus mengembalikan hanya ukuran total struktur DEVMODEW printer, termasuk anggota struktur publik dan privat, dalam anggota cbOut struktur DOCUMENTPROPERTYHEADER.
Jika anggota fMode dari struktur DOCUMENTPROPERTYHEADER bukan nol, fungsi harus melakukan operasi yang ditunjukkan oleh bendera fMode . Satu-satunya bendera yang mungkin diatur adalah DM_IN_BUFFER (atau DM_MODIFY), dan DM_OUT_BUFFER (atau DM_COPY).
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | winddiui.h (termasuk Winddiui.h) |