PrintManager Class

Informiert Windows, dass eine Anwendung beim Drucken teilnehmen möchte. Die PrintManager-Klasse wird auch für den programmgesteuerten Druckstart verwendet.

Syntax


var printManager = Windows.Graphics.Printing.PrintManager;

Attribute

[MarshalingBehavior(Agile)]
[Muse()]
[Version(0x06020000)]

Member

PrintManagerKlasse hat diese Membertypen:

Ereignisse

PrintManagerKlasse hat diese Ereignisse.

EreignisBeschreibung
PrintTaskRequested Raised when a request to print has occurred. This event may be triggered by user action or via programmatic invocation of printing via the ShowPrintUIAsync method.

 

Methoden

The PrintManager Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

MethodeBeschreibung
GetForCurrentView Retrieves the PrintManager object associated with the current window.
ShowPrintUIAsync Programattically initiates the user interface for printing content.

 

Hinweise

Der Druckmanager ist für die Organisation des Druckablaufs in einer Windows Store-App verantwortlich. Um diese Klasse verwenden, müssen Sie zuerst die GetForCurrentView-Methode aufrufen. Diese Methode gibt das PrintManager-Objekt zurück, das für das zurzeit aktive Fenster spezifisch ist. Dann müssen Sie einen Ereignislistener für das PrintTaskRequested-Ereignis hinzufügen. Dieses Ereignis wird vom System ausgelöst, wenn ein Benutzer angibt, dass ein Druckvorgang gestartet werden kann. In der Regel tritt dies auf, wenn der Benutzer den Charm „Geräte“ betätigt, das Ereignis aber möglicherweise ebenfalls programmgesteuert aufgerufen wird.

Die Klasse PrintManager enthält auch die ShowPrintUIAsync-Methode. Diese Methode kann von einer Anwendung verwendet werden, die GetForCurrentView bereits zum Abrufen von PrintManager verwendet und einen Listener für das PrintTaskRequested-Ereignis registriert hat, um den Druckvorgang für den Benutzer zu initiieren. Im Allgemeinen sollten Anwendungen den Benutzer Inhalte über den Charm "Geräte" ausdrucken lassen. Daher wird von der Verwendung der ShowPrintUIAsync-Methode abgeraten. ShowPrintUIAsync wird hauptsächlich für Szenarien bereitgestellt, in denen Sie Leitfäden Benutzer bereitstellen möchten, die beim Abschließen eines druckverwandten Prozesses helfen sollen. Beispielsweise eine Führung am Ende eines Ticketkaufvorgangs oder nach dem Einchecken für einen Flug und dann Ausdrucken einer Bordkarte.

Im Folgenden finden Sie einen JavaScript-Codeausschnitt, der zeigt, wie die App für einen Druckvertrag registriert wird:


    var app = WinJS.Application;

    // This function responds to all application activations.
    app.onactivated = function (eventObject) {
        if (eventObject.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.launch) {
           
            //Register for print contract
            var printManager = Windows.Graphics.Printing.PrintManager.getForCurrentView();
            printManager.onprinttaskrequested = onPrintTaskRequested;
        
            WinJS.UI.processAll();
        }
    };


Weitere Beispiele zum Druck-Manager und einen Beispielcode für das Drucken von Szenarien in Windows Store-Apps finden Sie im Entwicklungscenter unter Drucken.

Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

Windows.Graphics.Printing
Windows::Graphics::Printing [C++]

Metadaten

Windows.winmd

Siehe auch

Erstellen einer Windows Store-Geräte-App für Drucker
Entwickeln von v4-Drucktreibern
Drucken

 

 

Anzeigen:
© 2014 Microsoft