Sdílet prostřednictvím


PrintDialog Třída

Definice

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

public ref class PrintDialog
public class PrintDialog
type PrintDialog = class
Public Class PrintDialog
Dědičnost
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 == 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

Poznámky

Uživatel může v dialogovém okně 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 takovém smyslu lze ovládací prvek použít jako neviditelnou součást tisku. Z důvodů výkonu by však bylo lepší použít buď metodu AddJob , nebo jednu z mnoha Write metod a WriteAsync metody 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. Ten se používá s model Windows Forms aplikacemi. System.Windows.Controls.PrintDialogse používá s Windows Presentation Foundation aplikacemi.

Konstruktory

PrintDialog()

Inicializuje novou instanci PrintDialog třídy .

Vlastnosti

CurrentPageEnabled

Získá nebo nastaví hodnotu, která označ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 UserPageshodnotu .

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ý je používán PrintDialog při uživatel klepněte na tlačítko Tisk aktuální tiskové úlohy.

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á označuje, zda uživatelé dialogového okna Tisk mají možnost určit rozsahy stránek k tisku.

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
PrintDocument(DocumentPaginator, String)

Vytiskne DocumentPaginator objekt na PrintQueue aktuálně vybraný objekt.

PrintVisual(Visual, String)

Vytiskne objekt vizuálu (netextový) odvozený z Visual třídy do aktuálně vybraného objektu PrintQueue .

ShowDialog()

PrintDialog Vyvolá jako modální dialogové okno.

ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro