Freigeben über


PrintDialog Klasse

Definition

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
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)

Gilt für