PrintDialog Osztály

Definíció

Névtér:

System.Windows.Controls

Szerelvény:

PresentationFramework.dll

Meghív egy szabványos Microsoft Windows nyomtatási párbeszédpanelt, amely konfigurál egy PrintTicket és PrintQueue a felhasználói bemenetnek megfelelően, majd kinyomtat egy dokumentumot.

public ref class PrintDialog

public class PrintDialog

type PrintDialog = class

Public Class PrintDialog

Öröklődés

Object

PrintDialog

Példák

Az alábbi példa bemutatja, hogyan hozhat létre és jeleníthet meg egy egyszerű PrintDialog példányt az XAML (Extensible Application Markup Language) korrektúra és kód használatával.

<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

Megjegyzések

A felhasználó a Nyomtatás párbeszédpanelen kiválaszthatja a nyomtatót, konfigurálhatja és elvégezheti a nyomtatási feladatot.

Szigorúan véve a metódust a PrintDocument párbeszédpanel megnyitása nélkül is használhatja. Ebben az értelemben a vezérlő nem látható nyomtatási összetevőként használható. Teljesítménybeli okokból azonban jobb lenne, ha a AddJob metódust vagy a sok és Write a módszerek WriteAsync egyikét XpsDocumentWriterhasználnánk. Erről további információt az XPS-fájlok programozott nyomtatása című témakörben talál.

Ne keverje össze ezt az osztályt, System.Windows.Controls.PrintDialogSystem.Windows.Forms.PrintDialog. Ez utóbbit Windows Forms alkalmazásokhoz használják. System.Windows.Controls.PrintDialog Windows megjelenítési alaprendszer alkalmazásokkal használható.

Konstruktorok

Name	Description
PrintDialog()	Inicializálja a PrintDialog osztály új példányát.

Tulajdonságok

Name	Description
CurrentPageEnabled	Lekéri vagy beállít egy értéket, amely jelzi, hogy engedélyezve van-e az aktuális lap nyomtatása.
MaxPage	Lekéri vagy beállítja az oldaltartományokban engedélyezett legmagasabb oldalszámot.
MinPage	Lekéri vagy beállítja az oldaltartományokban engedélyezett legalacsonyabb oldalszámot.
PageRange	Lekéri vagy beállítja a nyomtatandó oldalak tartományát, ha PageRangeSelection be van állítva UserPages.
PageRangeSelection	Lekéri vagy beállítja PageRangeSelectiona PrintDialog példányt.
PrintableAreaHeight	Lekéri az oldal nyomtatható területének magasságát.
PrintableAreaWidth	Lekéri az oldal nyomtatható területének szélességét.
PrintQueue	Lekéri vagy beállítja PrintQueue a kiválasztott nyomtatót.
PrintTicket	Lekéri vagy beállítja azt, PrintTicket amelyet az PrintDialog a felhasználó használ, amikor a felhasználó a Nyomtatás gombra kattint az aktuális nyomtatási feladathoz.
SelectedPagesEnabled	Lekéri vagy beállít egy értéket, amely jelzi, hogy engedélyezve van-e a kijelölt lapok nyomtatása.
UserPageRangeEnabled	Lekéri vagy beállít egy értéket, amely jelzi, hogy a Nyomtatás párbeszédpanel felhasználói megadják-e a nyomtatni kívánt oldaltartományokat.

Metódusok

Name	Description
PrintDocument(DocumentPaginator, String)	DocumentPaginator Az aktuálisan kijelölt objektumot PrintQueue nyomtatja ki.
PrintVisual(Visual, String)	Az osztályból Visual származtatott vizualizációs (nem szöveges) objektumot a jelenleg kijelölt objektumra PrintQueue nyomtatja ki.
ShowDialog()	Meghívja a PrintDialog modális párbeszédpanelt.