Klasa CPrintDialog

Artykuł
02/27/2013

Hermetyzuje usług świadczonych przez wspólne okno dialogowe systemu Windows do drukowania.

class CPrintDialog : public CCommonDialog

Członkowie

Publiczne konstruktory

Nazwa	Opis
CPrintDialog::CPrintDialog	Konstrukcje CPrintDialog obiektu.

Metody publiczne

Nazwa	Opis
CPrintDialog::CreatePrinterDC	Tworzy kontekstu urządzenia drukarki bez wyświetlania okna dialogowego Drukuj.
CPrintDialog::DoModal	Wyświetla okno dialogowe i umożliwia użytkownikowi zaznaczanie jest niepotrzebne.
CPrintDialog::GetCopies	Pobiera numer kopie wymagane.
CPrintDialog::GetDefaults	Domyślne urządzenie pobiera bez wyświetlania okna dialogowego.
CPrintDialog::GetDeviceName	Pobiera nazwę urządzenia aktualnie wybranej drukarki.
CPrintDialog::GetDevMode	Pobiera DEVMODE struktury.
CPrintDialog::GetDriverName	Pobiera nazwę aktualnie zaznaczony sterownik drukarki.
CPrintDialog::GetFromPage	Pobiera strony początkowej zakres wydruku.
CPrintDialog::GetPortName	Pobiera nazwę portu aktualnie wybranej drukarki.
CPrintDialog::GetPrinterDC	Pobiera dojście do kontekstu urządzenia drukarki.
CPrintDialog::GetToPage	Pobiera strony końcowej zakresu wydruku.
CPrintDialog::PrintAll	Określa, czy drukowanie wszystkich stron dokumentu.
CPrintDialog::PrintCollate	Określa, czy sortowane kopie są wymagane.
CPrintDialog::PrintRange	Określa, czy drukowanie określonego zakresu stron.
CPrintDialog::PrintSelection	Określa, czy drukowanie aktualnie wybrane elementy.

Publiczne danych członków

Nazwa	Opis
CPrintDialog::m_pd	Struktura, używane do dostosowywania CPrintDialog obiektu.

Uwagi

Wspólne dialogowych drukowania pozwalają wykonania wydruku i ustawienia wydruku, okno dialogowe w sposób zgodny z normami systemu Windows.

[!UWAGA]

CPrintDialogEx Klasy hermetyzuje usług świadczonych przez system Windows 2000 drukowanie arkusza właściwości.Aby uzyskać więcej informacji, zobacz CPrintDialogEx omówienie.

CPrintDialogw funkcji jest zastąpione przez CPageSetupDialog, który ma dostarczyć wspólne okno dialogowe dla drukowania zarówno ustawienia i ustawienia strony.

Można polegać na ramy do obsługi wielu aspektów procesu drukowania z aplikacji.W przypadku ramach automatycznie wyświetla okno dialogowe wspólnego systemu Windows do drukowania.Można uchwyt ramy Drukowanie aplikacji mają jednak zastąpić wspólne okno dialogowe Drukuj własnego okna dialogowego drukowania.Aby uzyskać więcej informacji na temat przy użyciu framework do obsługi zadań drukowania, zobacz artykuł drukowania.

Jeśli aplikacja do obsługi drukowania bez zaangażowania w ramach można użyć CPrintDialog klasy "a" za pomocą konstruktora dostarczone lub można czerpać własnej klasy okno dialogowe z CPrintDialog i zapisu konstruktora do własnych potrzeb.W każdym przypadku tych okien dialogowych będzie działać jak standardowy MFC, okno dialogowe, ponieważ pochodzą one z klasy CCommonDialog.

Aby użyć CPrintDialog obiektów, należy najpierw utworzyć obiekt przy użyciu CPrintDialog konstruktora.Po oknie dialogowym została skonstruowana, można ustawić lub zmodyfikować wartości w m_pd struktury zainicjować wartości formantów w oknie dialogowym.m_pd Struktury jest typu PRINTDLG.Więcej informacji dotyczących tej struktury, zobacz Windows SDK.

Jeśli nie podasz własne uchwyty w m_pd dla pole hDevMode i hDevNames członków, należy wywołać funkcję Windows GlobalFree dla tych uchwytów, po zakończeniu okno dialogowe.Podczas korzystania z implementacji ustawienia wydruku ramy dostarczonych przez CWinApp::OnFilePrintSetup, nie trzeba zwolnić z tych uchwytów.Uchwyty są utrzymywane przez CWinApp i są zwalniane w CWinAppprzez destruktor.Jest tylko wolne tych uchwytów, korzystając z CPrintDialog autonomicznych.

Po inicjowanie formantów okna dialogowego, call DoModal Członkowskich funkcji wyświetlania okna dialogowego i umożliwia użytkownikowi wybranie opcji drukowania.DoModalZwraca się, czy użytkownik wybrał OK (IDOK) lub przycisk Anuluj (IDCANCEL) przycisk.

Jeśli DoModal zwraca IDOK, można użyć jednej z CPrintDialogw funkcji elementów członkowskich do pobierania informacji wprowadzania przez użytkownika.

CPrintDialog::GetDefaults Członkowskich funkcja jest przydatne do pobierania bez wyświetlania okna dialogowego bieżące ustawienia domyślne drukarki.Ta funkcja Członkowskich nie wymaga interakcji użytkownika.

Można użyć systemu Windows CommDlgExtendedError funkcji, aby ustalić, czy wystąpił błąd podczas inicjowania okna dialogowego i Dowiedz się więcej o błędzie.Aby uzyskać więcej informacji o tej funkcji, zobacz Windows SDK.

CPrintDialogkorzysta z pliku COMMDLG.Plik DLL, dostarczany z systemem Windows w wersji 3.1 lub nowszej.

Aby dostosować okno dialogowe, czerpią klasy z CPrintDialog, zapewniają szablonu niestandardowe okna dialogowe i dodać mapę wiadomości do przetwarzania wiadomości powiadomień z rozszerzonych formantów.Komunikaty nieprzetworzonych powinny być przekazywane do klasy podstawowej.Dostosowywanie funkcji haka nie jest wymagane.

Przetwarzanie tej samej wiadomości zależy, czy okno dialogowe jest ustawienia drukarki, musi pochodzić z klasy dla każdego okna dialogowego.Musi także zastępować Windows AttachOnSetup funkcji, która obsługuje tworzenie nowe okno dialogowe, gdy przycisk Ustawienia wydruku jest zaznaczony w oknie dialogowym Drukuj.

Aby uzyskać więcej informacji na temat używania CPrintDialog, zobacz Wspólne okno dialogowe klasy.