XPS OM Print Ticket Interfaces

Diese IXpsOMPrintTicketResource-Schnittstelle der XPS-Dokument-API bietet Zugriff auf ein vorhandenes Druckticket und auch die Möglichkeit, ein Druckticket in einem XPS-OM zu erstellen.

Die IXpsOMPrintTicketResource-Schnittstelle ermöglicht es einem Programm, den Inhalt eines vorhandenen Drucktickets zu lesen, indem die GetPrintTicketResource-Methode einer Schnittstelle aufgerufen wird, die ein Druckticket unterstützt. Neue Druckticketressourcen können einem Dokumentteil durch Aufrufen von SetPrintTicketResource hinzugefügt werden.

Es gibt drei Druckticketebenen, die den Umfang des Drucktickets angeben. Die Druckticketebenen sind: Die Auftragsebene (oder Paketebene), die Dokumentebene und die Seitenebene. Die folgende Tabelle zeigt die Beziehung zwischen der Druckticketebene, der entsprechenden XPS OM-Schnittstelle und den Methoden für den Zugriff auf die Druckticketressource.

Druckticketebene Schnittstelle Get-Methode Set-Methode
Auftrag IXpsOMDocumentSequence GetPrintTicketResource SetPrintTicketResource
Dokument IXpsOMDocument GetPrintTicketResource SetPrintTicketResource
Seite IXpsOMPageReference GetPrintTicketResource SetPrintTicketResource

 

Auf den Inhalt einer vorhandenen Druckticketressource kann über den Datenstrom zugegriffen werden, welcher der Ressource zugeordnet ist. Die GetStream-Methode der IXpsOMPrintTicketResource-Schnittstelle gibt den Zeiger auf einen schreibgeschützten Datenstrom zurück, der den XML-formatierten Inhalt des Drucktickets enthält. Das Format des Druckticketinhalts wird in der Druckschemaspezifikation beschrieben.

Eine neue Druckticketressource kann durch Erstellen einer neuen IXpsOMPrintTicketResource-Schnittstelle erstellt werden. Ein gültiges, XML-formatiertes Druckticket wird in einen Datenstrom geschrieben, und ein Teil-URI wird erstellt, um das Druckticketteil zu identifizieren. Weitere Informationen zum Inhalt eines gültigen Drucktickets finden Sie in der Druckschemaspezifikation. Der Datenstrom und der Teil-URI werden als Parameter des SetContent-Aufrufs übergeben, um die neue Druckticketressource festzulegen, und die Druckticketressource wird dem entsprechenden Dokumentteil hinzugefügt, indem die in der vorherigen Tabelle gezeigte SetPrintTicketResource-Methode aufgerufen wird.

Drucktickets erben die Eigenschaften von Drucktickets mit größerem Umfang. Beispielsweise erbt ein Druckticket auf Dokumentebene die Eigenschaften des Drucktickets auf Auftragsebene, die der Dokumentsequenz des Dokuments zugeordnet sind. Ebenso erbt ein Druckticket auf Seitenebene die Eigenschaften des Drucktickets auf Dokumentebene, die dem Dokumentdokument zugeordnet sind. In diesem Vererbungsprozess überschreiben Eigenschaften, die im Druckticket auf niedrigerer Ebene angegeben sind, die entsprechenden Eigenschaften, die andernfalls vom Druckticket auf höherer Ebene geerbt würden.

Druckschemaspezifikation

IXpsOMDocument

IXpsOMDocumentSequence

IXpsOMPageReference

IXpsOMPrintTicketResource

XML Paper Specification