Funzione AdvancedDocumentProperties

Articolo
06/12/2023

La funzione AdvancedDocumentProperties visualizza una finestra di dialogo di configurazione della stampante per la stampante specificata, consentendo all'utente di configurare tale stampante.

Questa funzione è un caso speciale della funzione DocumentProperties . Per altre informazioni, vedere la sezione Osservazioni.

Sintassi

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

Parametri

hWnd [in]: Handle nella finestra padre della finestra di dialogo stampante-configurazione.
hPrinter [in]: Handle a un oggetto stampante. Usare la funzione OpenPrinter o AddPrinter per recuperare un handle della stampante.
pDeviceName [in]: Puntatore a una stringa con terminazione null che specifica il nome del dispositivo per cui deve essere visualizzata una finestra di dialogo di configurazione della stampante.
pDevModeOutput [out]: Puntatore a una struttura DEVMODE che conterrà i dati di configurazione specificati dall'utente.
pDevModeInput [in]: Puntatore a una struttura DEVMODE contenente i dati di configurazione usati per inizializzare i controlli della finestra di dialogo di configurazione della stampante.

Valore restituito

Se la funzione DocumentProperties con questi parametri ha esito positivo, il valore restituito di AdvancedDocumentProperties è 1. In caso contrario, il valore restituito è zero.

Commenti

Nota

Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità con cui questa funzione restituisce dipende da fattori di runtime come lo stato della rete, la configurazione del server di stampa e i fattori di implementazione del driver della stampante difficili da prevedere durante la scrittura di un'applicazione. La chiamata a questa funzione da un thread che gestisce l'interazione con l'interfaccia utente potrebbe rendere l'applicazione non rispondente.

Questa funzione può visualizzare solo la finestra di dialogo di configurazione della stampante in modo che un utente possa configurarlo. Per altri controlli, usare DocumentProperties. I parametri di input per questa funzione vengono passati direttamente a DocumentProperties e il valore fMode è impostato su DM_IN_BUFFER | DM_IN_PROMPT | DM_OUT_BUFFER. A differenza di DocumentProperties, questa funzione restituisce solo 1 o 0. Pertanto, non è possibile determinare le dimensioni necessarie di DEVMODE impostando pDevMode su zero.

Un'applicazione può ottenere il nome indicato dal parametro pDeviceName chiamando la funzione GetPrinter e quindi esaminando il membro pPrinterName della struttura PRINTER_INFO_2.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	Winspool.drv
Nomi Unicode e ANSI	AdvancedDocumentPropertiesW (Unicode) e AdvancedDocumentPropertiesA (ANSI)

Vedi anche

Stampa
Funzioni dell'API spooler di stampa
Addprinter
DEVMODE
Proprietà documento
GetPrinter
OpenPrinter
PRINTER_INFO_2

Share via