PrintDialog Classe

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Invoca uma caixa de diálogo de impressão padrão do Microsoft Windows que configura um PrintTicket e PrintQueue de acordo com a entrada do usuário e imprime um documento.

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

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 nunca abrir a caixa de diálogo. Assim, o controle pode ser utilizado como um componente de impressão não visto. 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 Windows Forms. System.Windows.Controls.PrintDialogé usado com aplicativos Windows Presentation Foundation.

Construtores

PrintDialog()

Inicializa uma nova instância da classe PrintDialog.

Propriedades

CurrentPageEnabled	Obtém ou define um valor que indica se a opção para imprimir a página atual está habilitada.
MaxPage	Obtém ou define o maior número de páginas permitido em intervalos de página.
MinPage	Obtém ou define o menor número de páginas permitido em intervalos de página.
PageRange	Obtém ou define o intervalo de páginas a serem impressas quando PageRangeSelection for definido como UserPages.
PageRangeSelection	Obtém ou define o PageRangeSelection para esta instância de PrintDialog.
PrintableAreaHeight	Obtém a altura da área imprimível da página.
PrintableAreaWidth	Obtém a largura da área imprimível da página.
PrintQueue	Obtém ou define um PrintQueue que representa a impressora selecionada.
PrintTicket	Obtém ou define o PrintTicket que é usado pelo PrintDialog quando o usuário clica em Imprimir para o trabalho de impressão atual.
SelectedPagesEnabled	Obtém ou define um valor que indica se a opção para imprimir as páginas selecionadas está habilitada.
UserPageRangeEnabled	Obtém ou define um valor que indica se os usuários da caixa de diálogo Imprimir têm a opção de especificar intervalos de páginas a serem impressas.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
PrintDocument(DocumentPaginator, String)	Imprime um objeto DocumentPaginator para o PrintQueue que está selecionado no momento.
PrintVisual(Visual, String)	Imprime um objeto visual (não texto), que é derivado da classe Visual, ao PrintQueue que está selecionado no momento.
ShowDialog()	Invoca o PrintDialog como uma caixa de diálogo modal.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)