CPrintDialogEx-Klasse

Artikel
02/26/2013

Kapselt die Dienste, die vom Windows 2000druckseigenschaftenblatt bereitgestellt werden.

class CPrintDialogEx : public CCommonDialog

Mitglieder

Öffentliche Konstruktoren

Name	Description
CPrintDialogEx::CPrintDialogEx	Erstellt ein CPrintDialogEx-Objekt.

Öffentliche Methoden

Name	Description
CPrintDialogEx::CreatePrinterDC	Erstellt einen Druckergerätekontext, ohne das Dialogfeld Drucken anzuzeigen.
CPrintDialogEx::DoModal	Zeigt das Dialogfeld an und ermöglicht dem Benutzer, um auswählen kann.
CPrintDialogEx::GetCopies	Ruft die Anzahl der angeforderten Kopien ab.
CPrintDialogEx::GetDefaults	Ruft Gerätenstandards ab, ohne ein Dialogfeld anzuzeigen.
CPrintDialogEx::GetDeviceName	Ruft den Namen des Geräts des derzeit ausgewählten Druckers ab.
CPrintDialogEx::GetDevMode	Ruft die DEVMODE-Struktur ab.
CPrintDialogEx::GetDriverName	Ruft den Namen des systemdefinierten Druckergerätetreibers ab.
CPrintDialogEx::GetPortName	Ruft den Namen des aktuell Ports des ausgewählten Druckers ab.
CPrintDialogEx::GetPrinterDC	Ruft ein Handle für Druckergerätekontext ab.
CPrintDialogEx::PrintAll	Bestimmt, ob alle Seiten des Dokuments gedruckt wird.
CPrintDialogEx::PrintCollate	Bestimmt, ob sortierte Kopien angefordert werden.
CPrintDialogEx::PrintCurrentPage	Bestimmt, ob die aktuelle Seite des Dokuments gedruckt wird.
CPrintDialogEx::PrintRange	Bestimmt, ob nur einen bestimmten Seitenbereich ausgibt.
CPrintDialogEx::PrintSelection	Bestimmt, ob nur die aktuell ausgewählten Elemente ausgibt.

Öffentliche Datenmember

Name	Description
CPrintDialogEx::m_pdex	Eine Struktur verwendet, um ein CPrintDialogEx-Objekt anzupassen.

Hinweise

Sie können auf das Framework verlassen, um viele Aspekte des Druckvorgangs für die Anwendung zu behandeln.Weitere Informationen zum Verwenden des Frameworks, um Drucksaufgaben zu behandeln, finden Sie im Artikel Drucken.

Wenn Sie die Anwendung soll, Drucken ohne die Beteiligung des Frameworks zu behandeln, können Sie die Klasse verwenden CPrintDialogEx "z" mit dem bereitgestellten Konstruktor ist, oder eine eigene Dialogfeldklasse von CPrintDialogEx ableiten und einen Konstruktor schreiben, um Ihre Anforderungen anpassen.In beiden Fällen verhalten sich diese Dialogfelder wie Standard-MFC-Dialogfelder, da sie von der Klasse CCommonDialog abgeleitet werden.

Um ein CPrintDialogEx-Objekt zu verwenden, erstellen Sie zunächst das Objekt mithilfe des CPrintDialogEx-Konstruktors.Wenn das Dialogfeld erstellt wurde, können Sie alle Werte in der m_pdex-Struktur festlegen oder ändern, um die Werte der Steuerelemente des Dialogfelds zu initialisieren.Die m_pdex-Struktur ist vom Typ PRINTDLGEX.Weitere Informationen über diese Struktur, finden Sie unter Windows SDK.

Wenn Sie keine eigenen Handles in m_pdex für die hDevMode und hDevNames-Member angeben, stellen Sie sicher, die Windows-Funktion GlobalFree für diese Handles aufrufen, wenn Sie mit dem Dialogfeld geschehen.

Nachdem Sie die Dialogfeld-Steuerelemente initialisiert haben, rufen Sie die DoModal-Memberfunktion auf, um das Dialogfeld anzuzeigen und den Benutzer zu den ausgewählten Druckoptionen zu ermöglichen.Wenn DoModal zurückgibt, können Sie bestimmen, ob der Benutzer OK ausgewählt hat, wendet oder Schaltfläche abgebrochen wird.

Wenn der Benutzer auf OK geklickt hat, können Sie die Memberfunktionen von CPrintDialogEx verwenden, um die Informationseingabe durch den Benutzer abzurufen.

Die CPrintDialogEx::GetDefaults-Memberfunktion ist für das Abrufen der aktuellen Druckerstandards nützlich, ohne ein Dialogfeld anzuzeigen.Diese Methode erfordert keine Benutzerinteraktion.

Sie können die Funktion Windows CommDlgExtendedError verwenden, um mehr über den Fehler zu ermitteln, ob ein Fehler aufgetreten ist während der Initialisierung des Dialogfelds und zu erfahren.Weitere Informationen zu dieser Funktion finden Sie unter, Windows SDK.

Weitere Informationen zur Verwendung von CPrintDialogEx, finden Sie unter Allgemeine Dialogfeldklassen.