PrintTaskSourceRequestedHandler Delegat

  • Referenz

Definition

Namespace:
Windows.Graphics.Printing
Bearbeiten

Tritt auf, wenn ein Drucktask das Dokument zum Drucken anfordert. Das bereitgestellte Druckdokument muss die IPrintDocumentSource-Schnittstelle implementieren.

public delegate void PrintTaskSourceRequestedHandler(PrintTaskSourceRequestedArgs ^ args);
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1813028776, 23734, 19258, 134, 99, 243, 156, 176, 45, 201, 180)]
class PrintTaskSourceRequestedHandler : MulticastDelegate
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(1813028776, 23734, 19258, 134, 99, 243, 156, 176, 45, 201, 180)]
public delegate void PrintTaskSourceRequestedHandler(PrintTaskSourceRequestedArgs args);
var printTaskSourceRequestedHandlerHandler = function(args){
/* Your code */
}
Public Delegate Sub PrintTaskSourceRequestedHandler(args As PrintTaskSourceRequestedArgs)

Parameter

args
PrintTaskSourceRequestedArgs

Zeiger auf ein PrintTaskSourceRequestedArgs-Objekt .

Attribute
ContractVersionAttribute GuidAttribute

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

Der PrintTaskSourceRequestedHandler wird aufgerufen, um die Initialisierung eines PrintTask-Objekts abzuschließen. Dieses zweiphasige Initialisierungsmodell ist so konzipiert, dass eine App schnell auf das PrintTaskRequested-Ereignis reagieren kann, indem das PrintTask-Objekt erstellt wird. Später, wenn das Drucken tatsächlich aufgerufen wird, übernimmt PrintTaskSourceRequestedHandler die Arbeit, die erforderlich ist, um den Inhalt vorzubereiten, der in der Vorschau angezeigt und schließlich gedruckt werden soll. Die Frist für den Abschluss der Arbeiten im PrintTaskSourceRequestedHandler ist viel länger als die Frist für die Ausführung der Arbeit im PrintTaskRequested-Handler .

Betrachten Sie beispielsweise eine App, die Informationen aus der Cloud herunterladen muss, um den Druckvorgang für die Details einer Bordkarte abzuschließen. Die App sollte schnell auf das PrintTaskRequested-Ereignis reagieren, indem sie ein PrintTask-Objekt und einen Namen für den Druckvorgang erstellt, z. B. "Fabrikam-Bordkarte". Die App stellt dann PrintTaskSourceRequestedHandler mit einem Zeiger auf das PrintTask-Objekt bereit. Wenn dieser Handler aufgerufen wird, initiiert die App den Aufruf, um den tatsächlichen Inhalt der Bordkarte abzurufen, damit die Druckvorschau und der Druck ausgeführt werden können.

Eine App verfügt über zwei Optionen zum Erstellen eines Quellobjekts für ein Gedrucktes Dokument:

  • Verwenden Sie eine vom Framework bereitgestellte Druckdokumentquelle. Sowohl das HTML5/JavaScript- als auch das XAML-Framework bieten Implementierungen von Objekten, die die IPrintDocumentSource-Schnittstelle implementieren. Html5/JavaScript-Apps finden Sie unter MSApp.getHtmlPrintDocumentSource. Informationen zum Entwickeln druckfähiger Apps mit der erweiterbaren Anwendungsmarkupsprache (XAML) finden Sie unter Windows.UI.Xaml.Printing.PrintDocument.
  • Stellen Sie eine benutzerdefinierte Druckdokumentquelle bereit. Eine App kann eine eigene benutzerdefinierte Implementierung eines IPrintDocumentSource-Objekts bereitstellen. Dies erfordert ein gutes Verständnis von Direct2D und/oder den XPS-APIs. Ein Beispiel dafür, wie eine App eine eigene benutzerdefinierte Druckdokumentquelle bereitstellen kann, finden Sie im D2D-Druckbeispiel.

Gilt für:

Weitere Informationen