Imprimindo (HTML)

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Estes tópicos descrevem como imprimir conteúdo de um aplicativo da   Windows Store criado com JavaScript e HTML.

Esses tópicos pressupõem que você já entenda como escrever programas com JavaScript e HTML, por isso se concentram nas técnicas específicas à impressão a partir de aplicativos da Windows Store criados com JavaScript e HTML.

Visão geral

Para imprimir de um aplicativo no Windows 8, o aplicativo precisará acessar a impressão do Windows e fornecer o conteúdo formatado que será impresso.

Acessando a impressão do Windows

O aplicativo acessa a impressão do Windows registrando-se para o contrato do botão Imprimir em cada modo de exibição do aplicativo do qual você quer permitir impressão aos usuários. Registrar-se para o contrato do botão Imprimir significa obter um objeto PrintManager, criar um objeto PrintTask e manipular os eventos de impressão. Os artigos Guia de início rápido: imprimir a partir do seu aplicativo e Como imprimir usando um botão de impressão dentro do próprio aplicativo mostram como fazer isso.

Depois de se registrar para o contrato do botão Imprimir, o aplicativo pode personalizar a experiência de impressão, se necessário. O artigo Como mudar as configurações padrão na janela de impressão mostra uma maneira de personalizar a experiência de impressão padrão.

Visualização de impressão

A impressão do Windows fornece um recurso de visualização para todos os aplicativos que se registram para o contrato do botão Imprimir. Para oferecer a experiência mais consistente ao usuário, os aplicativos da Windows Store devem usar as funções de visualização de impressão fornecidas pela impressão do Windows em vez de criar um recurso de visualização de impressão específico do aplicativo.

Observação sobre o window.print()

A função JavaScript window.print() pode ser usada para imprimir o conteúdo do aplicativo, mas ela é voltada à impressão de conteúdo exibido na tela usando a experiência de impressão padrão. Infelizmente, o recurso que permite ótima exibição de um aplicativo da Windoes Store na tela nem sempre produz ótimas impressões. Como chamar window.print() para imprimir do aplicativo da Windows Store pode não proporcionar a melhor experiência ao cliente, é recomendável que o aplicativo use as funções de Tempo de Execução do Windows para se registrar para o contrato do botão Imprimir.

Fornecendo conteúdo formatado para impressão

Como a exibição em tela dos aplicativos da Windows Store provavelmente tem formatação diferente daquilo que teria boa aparência no papel, o aplicativo precisa criar uma cópia do conteúdo formatada especificamente para impressão.

Observação  Recursos de impressão personalizados, como impressão de páginas específicas ou configurações de impressão personalizadas, só podem ser adicionados a aplicativos da Windows Store em C++, C# ou Visual Basic e XAML. Para obter mais informações sobre a adição de recursos de impressão personalizada para seu aplicativo, veja Imprimindo (XAML).

 

Práticas recomendadas

O artigo Práticas recomendadas para desenvolver aplicativos da Windows Store com capacidade de impressão contém outras dicas valiosas para a impressão de conteúdo a partir do seu aplicativo.