PrintTaskSourceRequestedHandler Délégué
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.