Condividi tramite


Interfacce del ticket di stampa XPS OM

Questa interfaccia IXpsOMPrintTicketResource dell'API documento XPS consente di accedere a un ticket di stampa esistente e anche di creare un ticket di stampa in un file XPS OM.

L'interfaccia IXpsOMPrintTicketResource consente a un programma di leggere il contenuto di un ticket di stampa esistente chiamando il metodo GetPrintTicketResource di un'interfaccia che supporta un ticket di stampa. È possibile aggiungere nuove risorse ticket di stampa a una parte del documento chiamando SetPrintTicketResource.

Esistono tre livelli di ticket di stampa, che specificano l'ambito del ticket di stampa. I livelli di ticket di stampa sono: il livello di processo (o pacchetto), il livello del documento e il livello di pagina. Nella tabella seguente viene illustrata la relazione tra il livello del ticket di stampa, l'interfaccia XPS OM corrispondente e i metodi utilizzati per accedere alla risorsa ticket di stampa.

Livello ticket di stampa Interfaccia Metodo Get Metodo Set
Posizione IXpsOMDocumentSequence GetPrintTicketResource SetPrintTicketResource
Document IXpsOMDocument GetPrintTicketResource SetPrintTicketResource
Pagina IXpsOMPageReference GetPrintTicketResource SetPrintTicketResource

 

È possibile accedere al contenuto di una risorsa ticket di stampa esistente leggendo dal flusso associato alla risorsa. Il metodo GetStream dell'interfaccia IXpsOMPrintTicketResource restituisce il puntatore a un flusso di sola lettura contenente il contenuto in formato XML del ticket di stampa. Il formato del contenuto del ticket di stampa è descritto nella specifica dello schema di stampa.

È possibile creare una nuova risorsa ticket di stampa creando una nuova interfaccia IXpsOMPrintTicketResource. Un ticket di stampa in formato XML valido viene scritto in un flusso e viene creato un URI di parte per identificare la parte del ticket di stampa. Per altre informazioni sul contenuto di un ticket di stampa valido, vedere La specifica dello schema di stampa. Il flusso e l'URI della parte vengono passati come parametri della chiamata SetContent per impostare la nuova risorsa ticket di stampa e la risorsa ticket di stampa viene aggiunta alla parte del documento corrispondente chiamando il metodo SetPrintTicketResource illustrato nella tabella precedente.

I ticket di stampa ereditano le proprietà dei biglietti di stampa con un ambito maggiore. Ad esempio, un ticket di stampa a livello di documento eredita le proprietà del ticket di stampa a livello di processo associato alla sequenza di documento del documento. Analogamente, un ticket di stampa a livello di pagina eredita le proprietà del ticket di stampa a livello di documento associato al documento della pagina. In questo processo di ereditarietà, le proprietà specificate nel ticket di stampa di livello inferiore sostituiscono le proprietà corrispondenti che altrimenti verrebbero ereditate dal ticket di stampa di livello superiore.

Specifica dello schema di stampa

IXpsOMDocument

IXpsOMDocumentSequence

IXpsOMPageReference

IXpsOMPrintTicketResource

Specifica di carta XML