PrintDialog Třída

Definice

Obor názvů:

System.Windows.Controls

Sestavení:

PresentationFramework.dll

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

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