Udostępnij za pośrednictwem


PrintDialog Klasa

Definicja

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

Dotyczy