Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe PrintDialog

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

System.Object
  System.Windows.Controls.PrintDialog

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (em PresentationFramework.dll)
XMLNS para XAML http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public class PrintDialog
<PrintDialog .../>

O tipo PrintDialog expõe os membros a seguir.

  NomeDescrição
Método públicoPrintDialogInicializa uma nova instância da classe PrintDialog.
Superior

  NomeDescrição
Propriedade públicaCurrentPageEnabledObtém ou define um valor que indica se a opção de imprimir a página atual está ativada.
Propriedade públicaMaxPageObtém ou define o maior número de página que é permitido em intervalos de páginas.
Propriedade públicaMinPageObtém ou define o menor número de página que é permitido em intervalos de páginas.
Propriedade públicaPageRangeObtém ou define o intervalo de páginas a imprimir quando PageRangeSelection for definido como UserPages.
Propriedade públicaPageRangeSelectionObtém ou define o PageRangeSelection para esta instância do PrintDialog.
Propriedade públicaPrintableAreaHeightObtém a altura da área de impressão da página.
Propriedade públicaPrintableAreaWidthObtém a largura da área imprimível da página.
Propriedade públicaPrintQueueObtém ou define um PrintQueue que representa a impressora selecionada.
Propriedade públicaPrintTicketObtém ou define o PrintTicket que é usado pelo PrintDialog quando o usuário clica Imprimir para o trabalho de impressão atual.
Propriedade públicaSelectedPagesEnabledObtém ou define um valor que indica se a opção de imprimir as páginas selecionadas está ativada.
Propriedade públicaUserPageRangeEnabledObtém ou define um valor que indica se os usuários a Imprimir caixa de diálogo têm a opção de especificar intervalos de páginas a imprimir.
Superior

  NomeDescrição
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoFinalize Permite um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método públicoPrintDocumentImprime um DocumentPaginator o objeto para o PrintQueue que está selecionado no momento.
Método públicoPrintVisualImprime um objeto de visual (não-texto), que é derivado de Visual de classe, para o PrintQueue que está selecionado no momento.
Método públicoShowDialogChama o PrintDialog como um caixa de diálogo modal.
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Superior

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

Especificamente, você pode usar o método PrintDocument sem abrir o diálogo. Neste sentido, o controle pode ser usado como um componente de impressão sem ver. Mas por razões de performance, é melhor usar tanto o método AddJob ou um dos muitos métodos Write e WriteAsync do XpsDocumentWriter. Para obter mais informações sobre esse assunto, consulte Como imprimir arquivos XPS de forma programática.

Não confunda essa classe, System.Windows.Controls.PrintDialog, com System.Windows.Forms.PrintDialog. O segundo é usado com aplicativos Windows Forms. System.Windows.Controls.PrintDialog é usado com Windows Presentation Foundation (WPF) aplicativos.

O exemplo a seguir mostra como criar uma instância do e exibir uma simples PrintDialog usando Extensible Application Markup Language (XAML) marcação e código.


<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");
        }
    }


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Qualquer estático (Shared no Visual Basic) membro público desse tipo é thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft