PrintDialog Klasse

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ruft das Microsoft Windows-Standarddialogfeld „Drucken“ auf, das ein PrintTicket und eine PrintQueue entsprechend der Benutzereingabe konfiguriert und ein Dokument druckt.

public ref class PrintDialog

public class PrintDialog

type PrintDialog = class

Public Class PrintDialog

Vererbung

Object

PrintDialog

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie eine Instanz erstellen und eine PrintDialog einfache Anzeige mithilfe von Extensible Application Markup Language (XAML)-Markup und Code erstellen.

<Button Width="200" Click="InvokePrint">Invoke PrintDialog</Button>

...

private void InvokePrint(object sender, RoutedEventArgs e)
    {
        // Create the print dialog object and set options
        PrintDialog pDialog = new PrintDialog();
        pDialog.PageRangeSelection = PageRangeSelection.AllPages;
        pDialog.UserPageRangeEnabled = true;

        // Display the dialog. This returns true if the user presses the Print button.
        Nullable<Boolean> print = pDialog.ShowDialog();
        if (print == true)
        {
            XpsDocument xpsDocument = new XpsDocument("C:\\FixedDocumentSequence.xps", FileAccess.ReadWrite);
            FixedDocumentSequence fixedDocSeq = xpsDocument.GetFixedDocumentSequence();
            pDialog.PrintDocument(fixedDocSeq.DocumentPaginator, "Test print job");
        }
    }

Private Sub InvokePrint(ByVal sender As Object, ByVal e As RoutedEventArgs)
        ' Create the print dialog object and set options
        Dim pDialog As New PrintDialog()
        pDialog.PageRangeSelection = PageRangeSelection.AllPages
        pDialog.UserPageRangeEnabled = True

        ' Display the dialog. This returns true if the user presses the Print button.
        Dim print? As Boolean = pDialog.ShowDialog()
        If print = True Then
            Dim xpsDocument As New XpsDocument("C:\FixedDocumentSequence.xps", FileAccess.ReadWrite)
            Dim fixedDocSeq As FixedDocumentSequence = xpsDocument.GetFixedDocumentSequence()
            pDialog.PrintDocument(fixedDocSeq.DocumentPaginator, "Test print job")
        End If
End Sub

Hinweise

Ein Benutzer kann das Dialogfeld "Drucken " verwenden, um einen Drucker auszuwählen, ihn zu konfigurieren und einen Druckauftrag auszuführen.

Strengerweise können Sie die Methode verwenden, ohne das PrintDocument Dialogfeld zu öffnen. In diesem Sinne kann das Steuerelement als nicht angezeigte Druckkomponente verwendet werden. Aber aus Leistungsgründen wäre es besser, entweder die AddJob Methode oder eine der vielen Write und WriteAsync Methoden der XpsDocumentWriter. Weitere Informationen hierzu finden Sie unter How to: Programmgesteuertes Drucken von XPS-Dateien.

Verwechseln Sie diese Klasse System.Windows.Controls.PrintDialognicht mit System.Windows.Forms.PrintDialog. Dieser wird mit Windows Forms Anwendungen verwendet. System.Windows.Controls.PrintDialogwird mit Windows Presentation Foundation Anwendungen verwendet.

Konstruktoren

PrintDialog()

Initialisiert eine neue Instanz der PrintDialog-Klasse.

Eigenschaften

CurrentPageEnabled	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Option zum Drucken der aktuellen Seite aktiviert ist.
MaxPage	Ruft die größte in Seitenbereichen zulässige Seitenzahl ab, oder legt diese fest.
MinPage	Ruft die kleinste in Seitenbereichen zulässige Seitenzahl ab, oder legt diese fest.
PageRange	Ruft den zu druckenden Seitenbereich ab, wenn PageRangeSelection auf UserPages festgelegt ist, oder legt diesen fest.
PageRangeSelection	Ruft die PageRangeSelection für diese Instanz von PrintDialog ab, oder legt diese fest.
PrintableAreaHeight	Ruft die Höhe des druckbaren Bereichs der Seite ab.
PrintableAreaWidth	Ruft die Breite des druckbaren Bereichs der Seite ab.
PrintQueue	Ruft eine PrintQueue ab, die den ausgewählten Drucker darstellt.
PrintTicket	Ruft das PrintTicket ab, das vom PrintDialog verwendet wird, wenn der Benutzer für den aktuellen Auftrag auf Drucken klickt, oder legt diesen fest.
SelectedPagesEnabled	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Option zum Drucken der ausgewählten Seiten aktiviert ist.
UserPageRangeEnabled	Ruft einen Wert ab, der angibt, ob Benutzer des Dialogfelds Drucken die zu druckenden Seitenbereichen angeben können, oder legt diesen fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
PrintDocument(DocumentPaginator, String)	Druckt ein DocumentPaginator-Objekt in der derzeit ausgewählten PrintQueue.
PrintVisual(Visual, String)	Druckt ein visuelles Objekt (ohne Text), das von der Visual-Klasse abgeleitet ist, in der derzeit ausgewählten PrintQueue.
ShowDialog()	Ruft PrintDialog als modales Dialogfeld auf.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)