PrintManager Klasse

Referenz

Definition

Namespace:: Windows.Graphics.Printing

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt den Einstiegspunkt für das Drucken in einer Anwendung bereit.

public ref class PrintManager sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PrintManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PrintManager

Public NotInheritable Class PrintManager

Vererbung: Object Platform::Object IInspectable PrintManager

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die PrintManager-Klasse ist für die Orchestrierung des Druckflusses für UWP-Apps verantwortlich. Um diese Klasse zu verwenden, müssen Sie zuerst die GetForCurrentView-Methode aufrufen. Diese Methode gibt das PrintManager-Objekt zurück, das für das aktuell aktive Fenster spezifisch ist. Als Nächstes müssen Sie einen Ereignislistener für das PrintTaskRequested-Ereignis hinzufügen. Dieses Ereignis wird ausgelöst, wenn die Anwendung das Druckdialogfeld über die ShowPrintUIAsync-Methode aufruft.

Wenn eine UWP-App ihre "Druckabsicht" registriert, erstellt sie einen Druckvertrag mit dem Druck-Manager. Im UWP-Druckbeispiel wird die Registrierung von der RegisterForPrinting-Methode durchgeführt.

public virtual void RegisterForPrinting()
{
   printDocument = new PrintDocument();
   printDocumentSource = printDocument.DocumentSource;
   printDocument.Paginate += CreatePrintPreviewPages;
   printDocument.GetPreviewPage += GetPrintPreviewPage;
   printDocument.AddPages += AddPrintPages;

   PrintManager printMan = PrintManager.GetForCurrentView();
   printMan.PrintTaskRequested += PrintTaskRequested;
}

Weitere Beispiele für den Druck-Manager und einige Beispielcodebeispiele für Druckszenarien in UWP-Apps finden Sie unter Drucken und UWP-Druckbeispiel.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1607	14393	Issupported

Methoden

GetForCurrentView()	Ruft das PrintManager-Objekt ab, das dem aktuellen Fenster zugeordnet ist.
IsSupported()	Gibt an, ob die App auf einem Gerät ausgeführt wird, das das Drucken unterstützt.
ShowPrintUIAsync()	Initiiert programmgesteuert die Benutzeroberfläche für das Drucken von Inhalten.

Ereignisse

PrintTaskRequested

Wird ausgelöst, wenn eine Druckanforderung aufgetreten ist. Dieses Ereignis kann durch eine Benutzeraktion oder durch programmgesteuerten Aufruf des Drucks über die ShowPrintUIAsync-Methode ausgelöst werden.

Gilt für:

Freigeben über