Funzione AdvancedDocumentProperties
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 |
|
| Libreria |
|
| DLL |
|
| Nomi Unicode e ANSI |
AdvancedDocumentPropertiesW (Unicode) e AdvancedDocumentPropertiesA (ANSI) |