PrintManager Klasse
Definition
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.
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
- Attribute
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. |