PrintDlg

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);
 

Parametri

lppd
Puntatore a una struttura PRINTDLG che contiene informazioni utilizzate per inizializzare la finestra di dialogo. Quando PrintDlg ritorna, questa struttura contiene informazioni sulle selezioni dell'utente.

Valori restituiti

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

Osservazioni

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.

Descrizione

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.

Vedi anche

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.

Index