PrintDialog Klasa

Definicja

Przestrzeń nazw:

System.Windows.Controls

Zestaw:

PresentationFramework.dll

Wywołuje standardowe okno dialogowe drukowania systemu Windows Microsoft, które konfiguruje PrintTicket element i PrintQueue zgodnie z danymi wejściowymi użytkownika, a następnie drukuje dokument.

public ref class PrintDialog

public class PrintDialog

type PrintDialog = class

Public Class PrintDialog

Dziedziczenie

Object

PrintDialog

Przykłady

W poniższym przykładzie pokazano, jak utworzyć wystąpienie i wyświetlić proste PrintDialog przy użyciu znaczników i kodu extensible Application Markup Language (XAML).

<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

Uwagi

Użytkownik może użyć okna dialogowego Drukowanie , aby wybrać drukarkę, skonfigurować ją i wykonać zadanie drukowania.

Mówiąc ściśle, możesz użyć PrintDocument metody bez otwierania okna dialogowego. W tym sensie kontrolka może być używana jako niezaużywany składnik drukowania. Jednak ze względu na wydajność lepiej byłoby użyć AddJob metody lub jednej z wielu Write metod i WriteAsync metody XpsDocumentWriter. Aby uzyskać więcej informacji na ten temat, zobacz How to: Programmatically Print XPS Files (Instrukcje: Programowe drukowanie plików XPS).

Nie należy mylić tej klasy , System.Windows.Controls.PrintDialogz System.Windows.Forms.PrintDialog. Ten ostatni jest używany z aplikacjami Windows Forms. System.Windows.Controls.PrintDialogjest używany z aplikacjami Windows Presentation Foundation.

Konstruktory

PrintDialog()

Inicjuje nowe wystąpienie klasy PrintDialog.

Właściwości

CurrentPageEnabled	Pobiera lub ustawia wartość wskazującą, czy opcja drukowania bieżącej strony jest włączona.
MaxPage	Pobiera lub ustawia najwyższy numer strony dozwolony w zakresach stron.
MinPage	Pobiera lub ustawia najniższy numer strony dozwolony w zakresach stron.
PageRange	Pobiera lub ustawia zakres stron do drukowania, gdy PageRangeSelection jest ustawiony na UserPageswartość .
PageRangeSelection	Pobiera lub ustawia PageRangeSelection wartość dla tego wystąpienia klasy PrintDialog.
PrintableAreaHeight	Pobiera wysokość obszaru drukowania strony.
PrintableAreaWidth	Pobiera szerokość obszaru drukowania strony.
PrintQueue	Pobiera lub ustawia PrintQueue obiekt reprezentujący wybraną drukarkę.
PrintTicket	Pobiera lub ustawia PrintTicket wartość używaną PrintDialog przez użytkownika po kliknięciu przycisku Drukuj dla bieżącego zadania drukowania.
SelectedPagesEnabled	Pobiera lub ustawia wartość wskazującą, czy opcja drukowania wybranych stron jest włączona.
UserPageRangeEnabled	Pobiera lub ustawia wartość wskazującą, czy użytkownicy okna dialogowego Drukowanie mają możliwość określenia zakresów stron do drukowania.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
PrintDocument(DocumentPaginator, String)	Drukuje DocumentPaginator obiekt do aktualnie wybranego PrintQueue obiektu.
PrintVisual(Visual, String)	Drukuje obiekt wizualizacji (nietekstowy Visual ), który pochodzi z klasy , do aktualnie wybranego PrintQueue obiektu.
ShowDialog()	Wywołuje jako PrintDialog modalne okno dialogowe.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)