PrintDialog Třída

Definice

Obor názvů:

System.Windows.Controls

Sestavení:

PresentationFramework.dll

Vyvolá standardní dialogové okno tisku systému Microsoft Windows, které nakonfiguruje PrintTicket uživatelský vstup a PrintQueue pak vytiskne dokument.

public ref class PrintDialog

public class PrintDialog

type PrintDialog = class

Public Class PrintDialog

Dědičnost

Object

PrintDialog

Příklady

Následující příklad ukazuje, jak vytvořit instanci a zobrazit jednoduchou PrintDialog pomocí kódu XAML (Extensible Application Markup Language).

<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.Value)
    {
        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

Poznámky

Uživatel může pomocí dialogového okna Tisk vybrat tiskárnu, nakonfigurovat ji a provést tiskovou úlohu.

Přesněji řečeno, můžete použít metodu PrintDocument bez otevření dialogového okna. V tom smyslu lze ovládací prvek použít jako nezoznanou součást tisku. Ale z důvodů výkonu by bylo lepší použít buď metodu AddJob , nebo jednu z mnoha Write a WriteAsync metod XpsDocumentWriter. Další informace najdete v tématu Postupy: Tisk souborů XPS prostřednictvím kódu programu.

Nezaměňujte tuto třídu, System.Windows.Controls.PrintDialogs System.Windows.Forms.PrintDialog. Ta druhá se používá s aplikacemi Windows Forms. System.Windows.Controls.PrintDialog se používá s aplikacemi Windows Presentation Foundation.

Konstruktory

Name	Description
PrintDialog()	Inicializuje novou instanci PrintDialog třídy.

Vlastnosti

Name	Description
CurrentPageEnabled	Získá nebo nastaví hodnotu, která určuje, zda je možnost tisku aktuální stránky povolena.
MaxPage	Získá nebo nastaví nejvyšší číslo stránky, které je povoleno v rozsahech stránek.
MinPage	Získá nebo nastaví nejnižší číslo stránky, které je povoleno v rozsahech stránek.
PageRange	Získá nebo nastaví rozsah stránek k tisku, pokud PageRangeSelection je nastavena na UserPages.
PageRangeSelection	Získá nebo nastaví PageRangeSelection pro tuto instanci PrintDialog.
PrintableAreaHeight	Získá výšku tisknutelné oblasti stránky.
PrintableAreaWidth	Získá šířku tisknutelné oblasti stránky.
PrintQueue	Získá nebo nastaví PrintQueue , který představuje tiskárnu, která je vybrána.
PrintTicket	Získá nebo nastaví PrintTicket , který uživatel používá PrintDialog , když uživatel klikne na Tisk pro aktuální tiskovou úlohu.
SelectedPagesEnabled	Získá nebo nastaví hodnotu, která označuje, zda je možnost tisku vybraných stránek povolena.
UserPageRangeEnabled	Získá nebo nastaví hodnotu, která určuje, zda uživatelé dialogového okna Tisk mají možnost určit rozsahy stránek k tisku.

Metody

Name	Description
PrintDocument(DocumentPaginator, String)	Vytiskne DocumentPaginator objekt na PrintQueue aktuálně vybraný objekt.
PrintVisual(Visual, String)	Vytiskne objekt vizuálu (netext), který je odvozený z Visual třídy, na PrintQueue aktuálně vybraný objekt.
ShowDialog()	PrintDialog Vyvolá modální dialogové okno.