Interfaces de ticket d’impression d’OM XPS

  • Article

Cette interface IXpsOMPrintTicketResource de l’API Document XPS fournit l’accès à un ticket d’impression existant et la possibilité de créer un ticket d’impression dans un OM XPS.

L’interface IXpsOMPrintTicketResource permet à un programme de lire le contenu d’un ticket d’impression existant en appelant la méthode GetPrintTicketResource d’une interface prenant en charge un ticket d’impression. De nouvelles ressources de ticket d’impression peuvent être ajoutées à un composant de document en appelant SetPrintTicketResource.

Il existe trois niveaux de ticket d’impression, qui spécifient l’étendue du ticket d’impression. Les niveaux de ticket d’impression sont : le niveau du travail (ou package), le niveau du document et le niveau de la page. Le tableau suivant montre la relation entre le niveau du ticket d’impression, l’interface d’OM XPS correspondante et les méthodes utilisées pour accéder à la ressource de ticket d’impression.

Niveau du ticket d’impression Interface Get, méthode Set, méthode
Travail IXpsOMDocumentSequence GetPrintTicketResource SetPrintTicketResource
Document IXpsOMDocument GetPrintTicketResource SetPrintTicketResource
Page IXpsOMPageReference GetPrintTicketResource SetPrintTicketResource

 

Contenu du ticket d’impression

Le contenu d’une ressource de ticket d’impression existante est accessible en lisant le flux associé à la ressource. La méthode GetStream de l’interface IXpsOMPrintTicketResource retourne le pointeur vers un flux en lecture seule qui contient le contenu au format XML du ticket d’impression. Le format du contenu du ticket d’impression est décrit dans la Spécification du schéma d’impression.

Vous pouvez créer une ressource de ticket d’impression en créant une interface IXpsOMPrintTicketResource. Un ticket d’impression au format XML valide est écrit dans un flux et un URI de composant est créé pour identifier le composant du ticket d’impression. Pour plus d’informations sur le contenu d’un ticket d’impression valide, reportez-vous à la Spécification du schéma d’impression. Le flux et l’URI du composant sont passés en tant que paramètres de l’appel SetContent pour définir la nouvelle ressource de ticket d’impression et la ressource de ticket d’impression est ajoutée au composant de document correspondant en appelant la méthode SetPrintTicketResource indiquée dans le tableau précédent.

Les tickets d’impression héritent des propriétés des tickets d’impression avec une plus grande étendue. Par exemple, un ticket d’impression au niveau du document hérite des propriétés du ticket d’impression au niveau du travail associé à la séquence de documents du document. De même, un ticket d’impression au niveau de la page hérite des propriétés du ticket d’impression au niveau du document associé au document de la page. Dans ce processus d’héritage, les propriétés spécifiées dans le ticket d’impression de niveau inférieur remplacent les propriétés correspondantes qui seraient autrement héritées du ticket d’impression de niveau supérieur.

Spécification du schéma d’impression

IXpsOMDocument

IXpsOMDocumentSequence

IXpsOMPageReference

IXpsOMPrintTicketResource

XML Paper Specification