Partager via


PrintTaskSourceRequestedHandler Délégué

Définition

Se produit lorsqu’une tâche d’impression demande l’impression du document. Le document d’impression fourni doit implémenter l’interface IPrintDocumentSource .

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)

Paramètres

args
PrintTaskSourceRequestedArgs

Pointeur vers un objet PrintTaskSourceRequestedArgs .

Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

PrintTaskSourceRequestedHandler est appelé pour terminer l’initialisation d’un objet PrintTask . Ce modèle d’initialisation en deux phases est conçu pour permettre à une application de répondre rapidement à l’événement PrintTaskRequested en créant l’objet PrintTask . Ensuite, lorsque l’impression est réellement appelée, PrintTaskSourceRequestedHandler effectue le travail nécessaire pour préparer le contenu à afficher en prévisualisation et éventuellement à imprimer. L’échéance pour terminer le travail dans PrintTaskSourceRequestedHandler est beaucoup plus longue que l’échéance pour terminer le travail dans le gestionnaire PrintTaskRequested .

Par exemple, considérez une application qui doit télécharger des informations à partir du cloud pour terminer l’opération d’impression pour obtenir les détails d’une carte d’embarquement. L’application doit répondre rapidement à l’événement PrintTaskRequested en créant un objet PrintTask et un nom pour l’opération d’impression, par exemple « Fabrikam Boarding Pass ». L’application fournit ensuite PrintTaskSourceRequestedHandler avec un pointeur l’objet PrintTask . Lorsque ce gestionnaire est appelé, l’application lance l’appel pour récupérer le contenu réel de la carte d’embarquement afin que l’aperçu et l’impression puissent être effectuées.

Une application dispose de deux options pour créer un objet source de document d’impression :

  • Utilisez une source de document d’impression fournie par l’infrastructure. Les frameworks HTML5/JavaScript et XAML fournissent des implémentations d’objets qui implémentent l’interface IPrintDocumentSource . Pour les applications HTML5/JavaScript, consultez MSApp.getHtmlPrintDocumentSource. Pour plus d’informations sur le développement d’applications compatibles avec le langage XAML (Extensible Application Markup Language), consultez Windows.UI.Xaml.Printing.PrintDocument.
  • Fournissez une source de document d’impression personnalisée. Une application peut choisir de fournir sa propre implémentation personnalisée d’un objet IPrintDocumentSource . Pour ce faire, vous devez bien comprendre Direct2D et/ou les API XPS. Pour obtenir un exemple de la façon dont une application peut fournir sa propre source de document d’impression personnalisée, consultez l’exemple Impression D2D.

S’applique à

Voir aussi