PrintTaskRequest, classe

PrintTaskRequest Class

Contient la demande émanant du système de créer une tâche d'impression. Cet objet est disponible à partir de l'objet PrintTaskRequestedEventArgs passé à l'événement PrintTaskRequested.

Syntaxe


/* Pour plus d'informations sur la création ou l'accès à cet objet, consultez les notes. */

Attributs

[MarshalingBehavior(Agile)]
[Muse()]
[Version(0x06020000)]

Membres

PrintTaskRequestClasse possède ces types de membres :

Méthodes

The PrintTaskRequest Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
CreatePrintTask Creates a new PrintTask which indicates that the app has content to be printed.
GetDeferral Retrieves the deferral object associated with the PrintTaskRequest.

 

Propriétés

Le PrintTaskRequestClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

Deadline

En lecture seuleGets a DateTime value that indicates how long an app has to respond to the PrintTaskRequested event.

 

Remarques

La classe PrintTaskRequest est utilisée par une application pour créer un nouvel objet PrintTask . Un objet PrintTask est créé en réponse à l'événement PrintTaskRequested et il indique au système que l'application a le contenu à imprimer. Lors de la création d'un objet PrintTask à l'aide de la méthode CreatePrintTask, l'application doit fournir un nom pour la PrintTask et un gestionnaire d'événements PrintTaskSourceRequestedHandler appelé lorsque le contenu à imprimer est requis.

Une application doit effectuer la quantité minimale de travail possible dans le gestionnaire d'événements PrintTaskRequested étant donné que peu de temps est fournie pour une réponse. Dans la mesure du possible, l'application doit simplement créer une PrintTask et différer toute initialisation de contenu tant que le gestionnaire d'événements PrintTaskSourceRequestedHandler n'est pas appelé.

Si une application doit exécuter une opération asynchrone pendant l'opération PrintTaskRequested, elle doit extraire et utiliser un objet PrintTaskRequestedDeferral. Avant la sortie du gestionnaire d'événements, et en général avant le démarrage de l'opération asynchrone, l'application doit extraire l'objet PrintTaskRequestedDeferral en appelant la méthode GetDeferral de l'objet PrintTaskRequest. Lorsque l'opération asynchrone se termine, l'application doit appeler la méthode Complete de l'objet PrintTaskRequestedDeferral pour signaler que la demande de tâche d'impression est terminée. L'appel de la méthode Complete doit se produire avant que la propriété Deadline ne soit atteinte afin que la demande soit acceptée.

La méthode CreatePrintTask dans PrintTaskRequest peut être utilisée pour créer la tâche d'impression. Voici un extrait de code JavaScript qui montre comment créer une tâche d'impression :


    // Print event handler for printing via the PrintManager API.
    // printEvent contains the print task request object
    function onPrintTaskRequested(printEvent) {
        printEvent.request.createPrintTask("Print Sample", function (args) {
            args.setSource(MSApp.getHtmlPrintDocumentSource(document));
        }); 
    }


Pour voir la liste complète correspondante, et d'autres scénarios d'impression à l'aide de CreatePrintTask, voir la section relative à l'impression.

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.Graphics.Printing
Windows::Graphics::Printing [C++]

Métadonnées

Windows.winmd

Voir aussi

Impression

 

 

Afficher:
© 2017 Microsoft