Guide pratique pour imprimer à partir d’un programme Windows

Cette section explique comment imprimer à partir d’un programme Windows natif.

Vue d’ensemble

L’impression fait généralement partie intégrante d’un programme Windows natif. Par conséquent, il ne s’agit pas d’une fonctionnalité que vous pouvez ajouter facilement après avoir écrit le programme. Cela étant dit, si le programme est conçu pour utiliser des documents XPS, il n’aura pas besoin de beaucoup, le cas échéant, de code supplémentaire pour afficher le contenu du document pour l’impression. Les documents XPS de l’application peuvent être envoyés directement à une imprimante disposant d’un pilote d’imprimante XPSDrv.

Utilisez l’API de document XPS pour créer le contenu du document et l’API d’impression XPS pour envoyer le contenu du document à l’imprimante. L’API d’impression XPS traite le contenu du document pour l’imprimante de destination. Si l’imprimante sélectionnée a un pilote d’imprimante XPSDrv, le document est envoyé à l’imprimante sans aucune conversion supplémentaire. Si l’imprimante sélectionnée a un pilote d’imprimante basé sur GDI, le programme peut également envoyer le contenu à l’imprimante, et l’API d’impression XPS convertit le contenu du document afin qu’il soit compatible avec le pilote d’imprimante basé sur GDI. Dans les deux cas, le traitement effectué par l’application est le même.

Tâches d’impression

Les rubriques suivantes décrivent les étapes de base de l’impression du contenu du programme.

1. Collecter des informations sur le travail d’impression auprès de l’utilisateur.

   En règle générale, un utilisateur lance un travail d’impression lorsqu’il sélectionne l’option d’impression dans un menu et que le programme affiche une boîte de dialogue d’impression pour collecter les détails du travail d’impression. L’utilisateur sélectionne généralement l’imprimante, le nombre de copies et les détails de configuration de l’imprimante, tels que l’impression et l’agrafage à deux côtés.

   Pour plus d’informations sur la procédure à suivre, consultez Guide pratique pour collecter des informations sur le travail d’impression auprès de l’utilisateur.

2. Créer un indicateur de progression.

   Un indicateur de progression fournit à l’utilisateur des commentaires sur la progression du travail d’impression. L’indicateur de progression peut être une barre de progression qui fait partie d’une boîte de dialogue qui inclut le bouton Annuler pour le travail, ou il peut s’agir d’une barre de progression dans la barre de status en bas de la fenêtre main.

   Pour plus d’informations sur le fonctionnement de l’indicateur de progression, consultez Guide pratique pour afficher la progression du travail d’impression.

   Pour plus d’idées sur la façon d’afficher la progression du travail d’impression, consultez les informations contenues dans les instructions relatives au développement de l’interface utilisateur d’application Windows .

3. Démarrez le thread d’impression.

   Une fois que le programme a collecté les informations du travail d’impression auprès de l’utilisateur, il peut démarrer le thread d’impression pour effectuer le traitement réel du document en vue de l’impression.

   Pour plus d’informations sur le thread d’impression, consultez Guide pratique pour démarrer et arrêter un thread d’impression.

4. Restituer les données de travail d’impression.

   Le thread d’impression restitue les données du document pour l’impression. Vous devez décomposer ce traitement en étapes de traitement discrètes afin que l’utilisateur puisse interrompre le traitement et annuler le travail, ainsi que pour ne pas autoriser le thread de traitement à bloquer d’autres threads et processus.

   Pour plus d’informations sur le rendu des données de travail d’impression, consultez Guide pratique pour afficher les données du travail d’impression.

5. Surveiller la progression du travail d’impression.

   À mesure que chaque étape de traitement est effectuée, mettez à jour la barre de progression pour informer l’utilisation. Calculez les étapes de traitement pour terminer le travail demandé, puis mettez à jour la barre de progression au fur et à mesure que ces étapes sont effectuées.

6. Fermez le travail d’impression et arrêtez le thread d’impression.

   Une fois que le programme a envoyé le travail d’impression à l’imprimante, ou si l’utilisateur a annulé le travail d’impression, vous devez fermer le travail d’impression et libérer les ressources utilisées par le travail d’impression.

Rubriques connexes

Guide pratique pour collecter des informations sur le travail d’impression auprès de l’utilisateur