XPS OM Print Ticket Interfaces
Diese IXpsOMPrintTicketResource-Schnittstelle der XPS-Dokument-API ermöglicht den Zugriff auf ein vorhandenes Druckticket sowie die Möglichkeit, ein Druckticket in einem XPS OM zu erstellen.
Drucken von Ticketressourcen
Mit der IXpsOMPrintTicketResource-Schnittstelle kann ein Programm den Inhalt eines vorhandenen Drucktickets lesen, indem die GetPrintTicketResource-Methode einer Schnittstelle, die ein Druckticket unterstützt, aufruft. Neue Druckticketressourcen können einem Dokumentteil durch Aufrufen von SetPrintTicketResource hinzugefügt werden.
Es gibt drei Druckticketebenen, die den Bereich des Drucktickets angeben. Die Druckticketebenen sind: auftrags- oder paketebene, Dokumentebene und Seitenebene. Die folgende Tabelle zeigt die Beziehung zwischen der Druckticketebene, der entsprechenden XPS OM-Schnittstelle und den Methoden, die für den Zugriff auf die Druckticketressource verwendet werden.
| Druckticketebene | Schnittstelle | Get-Methode | Set-Methode |
|---|---|---|---|
| Auftrag | IXpsOMDocumentSequence | GetPrintTicketResource | SetPrintTicketResource |
| Dokument | IXpsOMDocument | GetPrintTicketResource | SetPrintTicketResource |
| Seite | IXpsOMPageReference | GetPrintTicketResource | SetPrintTicketResource |
Drucken von Ticketinhalten
Auf den Inhalt einer vorhandenen Druckticketressource kann zugegriffen werden, indem aus dem stream gelesen wird, der der Ressource zugeordnet ist. Die GetStream-Methode der IXpsOMPrintTicketResource-Schnittstelle gibt den Zeiger auf einen schreibgeschützten Stream zurück, der den XML-formatierten Inhalt des Drucktickets enthält. Das Format des Druckticketinhalts wird in der Spezifikation des Druckschemas beschrieben.
Eine neue Druckticketressource kann erstellt werden, indem eine neue IXpsOMPrintTicketResource-Schnittstelle erstellt wird. Ein gültiges, XML-formatiertes Druckticket wird in einen Stream geschrieben, und ein Teil-URI wird erstellt, um den Druckticketteil zu identifizieren. Weitere Informationen zum Inhalt eines gültigen Drucktickets finden Sie unter Spezifikation des Druckschemas. Der Stream und der Teil-URI werden als Parameter des SetContent-Aufrufs übergeben, um die neue Druckticketressource zu setzen, und die Druckticketressource wird dem entsprechenden Dokumentteil hinzugefügt, indem die in der obigen Tabelle gezeigte SetPrintTicketResource-Methode aufruft.
Drucken der Ticketvererbung
Drucktickets erben die Eigenschaften von Drucktickets mit größerem Umfang. Beispielsweise erbt ein Druckticket auf Dokumentebene die Eigenschaften des Drucktickets auf Auftragsebene, das der Dokumentsequenz des Dokuments zugeordnet ist. Ebenso erbt ein Druckticket auf Seitenebene die Eigenschaften des Drucktickets auf Dokumentebene, das dem Dokument der Seite zugeordnet ist. In diesem Vererbungsprozess überschreiben Eigenschaften, die im Druckticket auf niedrigerer Ebene angegeben sind, die entsprechenden Eigenschaften, die andernfalls vom übergeordneten Druckticket geerbt würden.