La funzione PrintDlg Visualizza una finestra di dialogo stampa o una finestra di dialogo di stampadiSetup . Nella finestra di dialogo di stampa consente all'utente di specificare le proprietà di un particolare processo di stampa .
La finestra di dialogo stampaSetup non deve essere utilizzato nelle nuove applicazioni. Essa è stata sostituita dalla PageSetup dialogo comune creato dalla funzione PageSetupDlg .
(BOOL PrintDlg LPPRINTDLG lppd / / puntatore alla struttura con dati di inizializzazione);
Se l'utente fa clic sul pulsante OK , il valore restituito è diverso da zero. I membri della struttura PRINTDLG ha sottolineato dal parametro lppd indicano le selezioni dell'utente.
Se l'utente annullata o chiuso la finestra di dialogo stampa o Configurazione stampante o si è verificato un errore, il valore restituito è zero. Per ottenere informazioni di errore estese, utilizzare la funzione CommDlgExtendedError . Se l'utente annullato o chiuso la finestra di dialogo, CommDlgExtendedError restituisce zero; in caso contrario, restituisce uno dei valori seguenti:
| CDERR_FINDRESFAILURE | PDERR_CREATEICFAILURE |
| CDERR_INITIALIZATION | PDERR_DEFAULTDIFFERENT |
| CDERR_LOADRESFAILURE | PDERR_DNDMMISMATCH |
| CDERR_LOADSTRFAILURE | PDERR_GETDEVMODEFAIL |
| CDERR_LOCKRESFAILURE | PDERR_INITFAILURE |
| CDERR_MEMALLOCFAILURE | PDERR_LOADDRVFAILURE |
| CDERR_MEMLOCKFAILURE | PDERR_NODEFAULTPRN |
| CDERR_NOHINSTANCE | PDERR_NODEVICES |
| CDERR_NOHOOK | PDERR_PARSEFAILURE |
| CDERR_NOTEMPLATE | PDERR_PRINTERNOTFOUND |
| CDERR_STRUCTSIZE | PDERR_RETDEFFAILURE |
Se la routine di hook (indicata dal membro della struttura PRINTDLG lpfnPrintHook o lpfnSetupHook ) elabora il messaggio WM_CTLCOLORDLG, la routine di hook deve restituire un handle per il pennello che deve essere utilizzato per disegnare lo sfondo del controllo.
Windows NT 5.0 e versioni successive: È possibile utilizzare la funzione PrintDlgEx per visualizzare una finestra delle proprietà di stampa, che ha una pagina generale che contiene controlli simili a dialogo stampa comune.
Windows CE: La struttura PRINTDLG contiene diversi membri in Windows CE di quanto non faccia in piattaforme desktop di Windows.
nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 2.0 o successiva.
Intestazione:Dichiarati in commdlg.h.
Importare librerie:Utilizzare comdlg32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.
Comune di dialogo casella libreria panoramica, funzioni di dialogo comune, CommDlgExtendedError, CreateDC, DOCINFO, PRINTDLG, PrintHookProc, SetupHookProc, StartDoc, WM_CTLCOLORDLG
Rimedio: Inserire il CD-ROM CD di MSDN Library.