Fungsi AdvancedDocumentProperties

Artikel
06/12/2023

Fungsi AdvancedDocumentProperties menampilkan kotak dialog konfigurasi printer untuk printer yang ditentukan, memungkinkan pengguna untuk mengonfigurasi printer tersebut.

Fungsi ini adalah kasus khusus dari fungsi DocumentProperties . Untuk detail selengkapnya, lihat bagian Keterangan.

Sintaks

LONG AdvancedDocumentProperties(
  _In_  HWND     hWnd,
  _In_  HANDLE   hPrinter,
  _In_  LPTSTR   pDeviceName,
  _Out_ PDEVMODE pDevModeOutput,
  _In_  PDEVMODE pDevModeInput
);

Parameter

hWnd [in]: Handel ke jendela induk kotak dialog konfigurasi printer.
hPrinter [in]: Handel ke objek printer. Gunakan fungsi OpenPrinter atau AddPrinter untuk mengambil handel printer.
pDeviceName [in]: Penunjuk ke string yang dihentikan null yang menentukan nama perangkat tempat kotak dialog konfigurasi printer harus ditampilkan.
pDevModeOutput [out]: Penunjuk ke struktur DEVMODE yang akan berisi data konfigurasi yang ditentukan oleh pengguna.
pDevModeInput [in]: Penunjuk ke struktur DEVMODE yang berisi data konfigurasi yang digunakan untuk menginisialisasi kontrol kotak dialog konfigurasi printer.

Menampilkan nilai

Jika fungsi DocumentProperties dengan parameter ini berhasil, nilai pengembalian AdvancedDocumentProperties adalah 1. Jika tidak, nilai yang dikembalikan adalah nol.

Keterangan

Catatan

Ini adalah fungsi pemblokiran atau sinkron dan mungkin tidak segera kembali. Seberapa cepat fungsi ini kembali tergantung pada faktor run-time seperti status jaringan, konfigurasi server cetak, dan faktor implementasi driver printer yang sulit diprediksi saat menulis aplikasi. Memanggil fungsi ini dari utas yang mengelola interaksi dengan antarmuka pengguna dapat membuat aplikasi tampak tidak responsif.

Fungsi ini hanya dapat menampilkan kotak dialog konfigurasi printer sehingga pengguna dapat mengonfigurasinya. Untuk kontrol lainnya, gunakan DocumentProperties. Parameter input untuk fungsi ini diteruskan langsung ke DocumentProperties dan nilai fMode diatur ke DM_IN_BUFFER | DM_IN_PROMPT | DM_OUT_BUFFER. Tidak seperti DocumentProperties, fungsi ini hanya mengembalikan 1 atau 0. Dengan demikian, Anda tidak dapat menentukan ukuran DEVMODE yang diperlukan dengan mengatur pDevMode ke nol.

Aplikasi dapat memperoleh nama yang diacu oleh parameter pDeviceName dengan memanggil fungsi GetPrinter dan kemudian memeriksa anggota pPrinterName dari struktur PRINTER_INFO_2 .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Winspool.h (termasuk Windows.h)
Pustaka	Winspool.lib
DLL	Winspool.drv
Nama Unicode dan ANSI	AdvancedDocumentPropertiesW (Unicode) dan AdvancedDocumentPropertiesA (ANSI)

Lihat juga

Pencetakan
Cetak Fungsi API Spooler
TambahkanPrinter
DEVMODE
DocumentProperties
GetPrinter
OpenPrinter
PRINTER_INFO_2

Bagikan melalui