PrintDlg

Funcția PrintDlg afișează o casetă de dialog tipărire sau o casetă de dialog deconfigurare tipărire. Caseta de dialog Imprimare permite utilizatorului pentru a specifica proprietățile de un loc de muncă speciale de imprimare .

Caseta de dialogInițializare Imprimarenu ar fi utilizate în aplicații noi. Acesta a fost înlocuit cu paginacomune caseta de dialogconfigurare creat de funcția PageSetupDlg .

(BOOL PrintDlg LPPRINTDLG  lppd / / indicatorul structura datelor de ini?ializare);

Parametrii

lppd
Indicator spre o structură PRINTDLG care conține informații folosite pentru a initializa caseta de dialog. Când se întoarce PrintDlg , această structură conține informații despre selecțiile utilizatorului.

Valorile întroarse

În cazul în care utilizatorul face clic pe butonul OK , valoarea returnată este diferită de zero. Membrii structurii PRINTDLG a subliniat prin parametrul lppd indică utilizatorului selecții.

În cazul în care utilizatorul a revocat sau închis caseta de dialog Imprimare sau Instalare imprimantă sau o eroare, valoarea returnată este zero. Pentru a ob?ine informa?ii extinse despre erori, utilizați funcția CommDlgExtendedError . În cazul în care utilizatorul a revocat sau închis caseta de dialog, CommDlgExtendedError returnează zero; în caz contrar, se întoarce una din următoarele valori:

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

Observații

Dacă procedura cârlig (a subliniat de membru lpfnPrintHook sau lpfnSetupHook de structura PRINTDLG ) procesează mesajul WM_CTLCOLORDLG, procedura cârlig trebuie să returneze un mâner pentru pensulă care trebuie utilizate pentru a picta fundal control.

Windows NT 5.0 și mai târziu: Utilizați funcția PrintDlgEx pentru a afișa o imprima foaia de proprietăți, care are o pagină General care conține controale similare în caseta de dialog comune de Imprimare.

Windows CE: Structura PRINTDLG conține diferite membrii în Windows CE decât în platformelor Windows desktop.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 2.0 sau mai târziu.
Antet:A declarat în commdlg.h.
Import Biblioteca:Utilizarea comdlg32.lib.
Unicode:Pus în aplicare ca Unicode și ANSI versiuni Windows NT.

A se vedea, de asemenea

Comune Dialog Box biblioteca prezentare generală, funcții comune caseta de Dialog, CommDlgExtendedError, CreateDC, , DOCINFO, PRINTDLG, PrintHookProc, SetupHookProc, StartDoc, WM_CTLCOLORDLG

Index