PrintDialog Classe

Definição

public ref class PrintDialog

public class PrintDialog

type PrintDialog = class

Public Class PrintDialog

Herança

Object

PrintDialog

Exemplos

O exemplo a seguir mostra como criar uma instância e exibir uma simples PrintDialog usando a marcação e o código da 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

Comentários

Um usuário pode usar a caixa de diálogo Imprimir para selecionar uma impressora, configurá-la e executar um trabalho de impressão.

Estritamente falando, você pode usar o PrintDocument método sem abrir a caixa de diálogo. Nesse sentido, o controle pode ser usado como um componente de impressão invisível. Mas, por motivos de desempenho, seria melhor usar o AddJob método ou um dos muitos Write e WriteAsync métodos do XpsDocumentWriter. Para obter mais informações sobre isso, consulte Como imprimir arquivos XPS programaticamente.

Não confunda essa classe, System.Windows.Controls.PrintDialogcom System.Windows.Forms.PrintDialog. Este último é usado com aplicativos do Windows Forms. System.Windows.Controls.PrintDialog é usado com aplicativos do Windows Presentation Foundation.