Visão geral da biblioteca de extensões de impressora para aplicativos de dispositivo UWP

Este tópico apresenta a biblioteca de extensões de impressora, uma biblioteca que ajuda os fabricantes de dispositivos a escrever aplicativos de dispositivo UWP para suas impressoras. A biblioteca de extensões de impressora está incluída no exemplo Configurações de impressão e notificaçõesConfigurações de impressão e notificações de impressão, e também no exemplo Gerenciamento de tarefas e manutenção de impressora.

Visão geral

Uma meta de design de alto nível para a arquitetura de driver de impressora v4 era fornecer suporte interno para a interface do usuário do aplicativo da Microsoft Store. Para fornecer acesso à impressora, o driver de impressão v4 expõe Interfaces de extensão de impressora baseadas em COM.

Para acessar essas interfaces de seu aplicativo de dispositivo UWP, você pode usar a biblioteca de extensões de impressora incluída com os exemplos de impressora de aplicativo de dispositivo da Microsoft Store. A biblioteca de extensões de impressora encapsula a implementação COM da interface COM PrinterExtensionLib. Isso permite o compartilhamento de código entre extensões de impressora e seu aplicativo de dispositivo UWP.

PrinterExtensionLibrary

No projeto PrinterExtensionLibrary que está incluído com os exemplos de impressora, há dois arquivos C#. Estes arquivos encapsulam o conteúdo de PrinterExtensionLib. Porém, outras classes poderão ser adicionadas nessa camada para habilitar o compartilhamento de código entre extensões de impressora e aplicativos de dispositivo UWP.

• PrinterExtensionTypes.cs especifica uma série de enumerações, constantes e interfaces úteis que encapsulam as APIs COM PrinterExtensionLib.

• PrinterExtensionAdapters.cs especifica todas as classes passíveis de construção usadas para encapsular as APIs COM PrinterExtensionLib.

Você pode aumentar este projeto com qualquer arquivo C# necessário que descreva o código de camada de modelo comum necessário para criar sua extensão de impressora e/ou aplicativo de dispositivo UWP. No entanto, não recomendamos atualizar as classes existentes, pois isso tornará mais difícil incorporar quaisquer correções de bugs disponibilizadas por meio de atualizações aos exemplos.

DeviceAppForPrintersLibrary

Um projeto adicional denominado DeviceAppForPrintersLibrary fornece classes auxiliares e métodos para aplicativos C# que você pode usar para acessar impressoras de seu aplicativo de dispositivo UWP.

PrinterExtensionHelperLibrary

Para converter as interfaces, as classes e os métodos C# em algo compatível com JavaScript, este projeto criará um arquivo WinMD. Os arquivos WinMD especificam APIs do Windows Runtime. Além disso, essa biblioteca pode ser usada para expor objetos de conveniência específicos para os aplicativos de dispositivo da Microsoft Store, como analisar diferentes contextos de ativação ou criar a interface do usuário do sistema para notificações.

• PrintHelperClass.cs inclui os namespaces PrinterExtensionLibrary para expô-los a camadas JavaScript no aplicativo. Ele também inclui alguns métodos de conveniência para PrintTicket e Bidi.

• PrinterNotificationHelper.cs demonstra como mostrar a interface do usuário do sistema para notificações.

O Tipo de saída para o assembly PrinterExtensionHelperLibrary é especificado na página Aplicativo da janela de propriedades do projeto.

Tópicos relacionados

Desenvolvendo drivers de impressão v4

Interfaces de extensão de impressora (driver de impressão v4)

Gerenciamento de trabalho (driver de impressora v4)

Manutenção do dispositivo (driver de impressora v4)

Comunicação bidirecional

Introdução aos aplicativos UWP

Criar um aplicativo de dispositivo UWP (guia passo a passo)

Criar metadados de dispositivo para um aplicativo de dispositivo UWP (guia passo a passo)