PrintDlg

Funkcja PrintDlg wyświetla okno dialogowe Drukuj lub okno dialogoweUstawienia wydruku. Okno dialogowe Drukuj umożliwia użytkownikowi określenie właściwości określonego zadania drukowania .

Okno dialogoweUstawienia wydrukunie powinna służyć w nowych zastosowań. Został zastąpiony przez stronęUstawienia wspólne okno dialogowe utworzone przez funkcję PageSetupDlg .

(BOOL PrintDlg LPPRINTDLG  lppd / / wskaźnika do struktury danych inicjujących);
 

Parametry

lppd
Wskaźnik do struktury PRINTDLG , który zawiera informacje używane do inicjowania okna dialogowego. Po PrintDlg , ta struktura zawiera informacje wybrane przez użytkownika.

Zwraca wartości

Jeśli użytkownik kliknie przycisk OK , wartość zwracany jest różna od zera. Członkowie struktury PRINTDLG wskazywanego przez parametr lppd wskazuje zaznaczenia przez użytkownika.

Jeśli użytkownik anulowane lub zamknięciu okna dialogowego Drukuj lub Ustawienia drukarki lub wystąpił błąd, wartość zwracany jest równa zero. Aby uzyskać informacje o błąd rozszerzony, należy użyć funkcji CommDlgExtendedError . Jeśli użytkownik anulował lub zamknąć okno dialogowe, CommDlgExtendedError zwraca zero; w przeciwnym razie zwraca ona jedną z następujących wartości:

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

Uwagi

Jeśli procedura haka (wskazywanego przez element lpfnPrintHook lub lpfnSetupHook struktury PRINTDLG ) przetwarza wiadomość WM_CTLCOLORDLG, procedura haka musi zwracać uchwyt pędzla, który powinien być używany do malowania tła formantu.

Systemu Windows NT 5.0 i nowsze: Funkcja PrintDlgEx umożliwia wyświetlanie, Drukowanie arkusza właściwości, która ma stronę Ogólne zawierającą formanty, podobnie jak wspólne okno dialogowe Drukuj.

Systemu Windows CE: Struktura PRINTDLG zawiera różnych członków systemu Windows CE może działa na platformach pulpitu systemu Windows.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga w wersji 2.0 lub nowszej.
Nagłówka:Zadeklarowane w commdlg.h.
Importowanie biblioteki:Należy użyć comdlg32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Wspólny omówienie biblioteki okna dialogowego, wspólne okno dialogowe Funkcje, CommDlgExtendedError, CreateDC, DOCINFO, PRINTDLG, PrintHookProc, SetupHookProc, StartDoc, WM_CTLCOLORDLG

Index