Freigeben über


Übersicht über die Druckererweiterungsbibliothek für UWP-Geräte-Apps

In diesem Thema wird die Druckererweiterungsbibliothek vorgestellt, eine Bibliothek, mit der Gerätehersteller UWP-Geräte-Apps für ihren Drucker schreiben können. Die Druckererweiterungsbibliothek ist im Beispiel Druckeinstellungen und Druckbenachrichtigungen sowie im Beispiel Auftragsverwaltung und Druckerwartung enthalten.

Überblick

Ein übergeordnetes Designziel für die v4-Druckertreiberarchitektur bestand darin, integrierte Unterstützung für die Benutzeroberfläche der Microsoft Store-App bereitzustellen. Um Zugriff auf den Drucker zu ermöglichen, macht der v4-Drucktreiber COM-basierte Druckererweiterungsschnittstellen verfügbar.

Um auf diese Schnittstellen aus Ihrer UWP-Geräte-App zuzugreifen, können Sie die Druckererweiterungsbibliothek verwenden, die in den Microsoft Store-Geräte-App-Druckerbeispielen enthalten ist. Die Druckererweiterungsbibliothek umschließt die COM-Implementierung der COM-Schnittstelle PrinterExtensionLib. Dies ermöglicht die Codefreigabe zwischen Druckererweiterungen und Ihrer UWP-Geräte-App.

printer extension library overview.

PrinterExtensionLibrary

Innerhalb des PrinterExtensionLibrary-Projekts, das in den Druckerbeispielen enthalten ist, gibt es zwei C#-Dateien. Diese Dateien umschließen den Inhalt von PrinterExtensionLib. Auf dieser Ebene können jedoch zusätzliche Klassen hinzugefügt werden, um die Codefreigabe zwischen Druckererweiterungen und UWP-Geräte-Apps zu ermöglichen.

  • PrinterExtensionTypes.cs gibt eine Reihe hilfreicher Enumerationen, Konstanten und Schnittstellen an, die die COM PrinterExtensionLib-APIs umschließen.

  • PrinterExtensionAdapters.cs gibt alle konstruierbaren Klassen an, die zum Umschließen der COM PrinterExtensionLib-APIs verwendet werden.

Sie können dieses Projekt mit allen erforderlichen C#-Dateien erweitern, die allgemeinen Modellebenencode beschreiben, der zum Erstellen der Druckererweiterung und/oder der UWP-Geräte-App erforderlich ist. Es wird jedoch nicht empfohlen, die vorhandenen Klassen zu aktualisieren, da dies es schwieriger macht, alle Fehlerkorrekturen zu integrieren, die über Updates für die Beispiele zur Verfügung gestellt wurden.

DeviceAppForPrintersLibrary

Ein zusätzliches Projekt mit dem Namen DeviceAppForPrintersLibrary stellt Hilfsklassen und Methoden für C#-Apps bereit, die Sie für den Zugriff auf Drucker aus Ihrer UWP-Geräte-App verwenden können.

PrinterExtensionHelperLibrary

Um die C#-Schnittstellen, Klassen und Methoden in etwas zu konvertieren, das in JavaScript unterstützt wird, erstellt dieses Projekt eine WinMD-Datei. WinMD-Dateien geben Windows-Runtime-APIs an. Darüber hinaus kann diese Bibliothek verwendet werden, um Komfortobjekte verfügbar zu machen, die spezifisch für die Microsoft Store-Geräte-Apps sind, z. B. das Parsen verschiedener Aktivierungskontexte oder das Erstellen einer Toast-Benutzeroberfläche für Benachrichtigungen.

  • PrintHelperClass.cs enthält die PrinterExtensionLibrary-Namespaces, um sie javaScript-Ebenen in der App verfügbar zu machen. Es enthält auch einige Komfortmethoden für PrintTicket und Bidi.

  • PrinterNotificationHelper.cs veranschaulicht, wie Popup-UI für Benachrichtigungen angezeigt wird.

Der Ausgabetyp für die PrinterExtensionHelperLibrary-Assembly wird auf der Anwendungsseite des Projekteigenschaftenfensters angegeben.

Entwickeln von v4-Drucktreibern

Druckererweiterungsschnittstellen (v4 Drucktreiber)

Auftragsverwaltung (v4-Druckertreiber)

Gerätewartung (v4 Druckertreiber)

Bidirektionale Kommunikationen

Erste Schritte mit UWP-Apps

Erstellen einer UWP-Geräte-App (schrittweise Anleitung)

Erstellen von Gerätemetadaten für eine UWP-Geräte-App (schrittweise Anleitung)