Interfaces do Tíquete de Impressão do Modelo de Objeto XPS

  • Artigo

Essa interface IXpsOMPrintTicketResource da API do Documento XPS fornece acesso a um tíquete de impressão existente e também a capacidade de criar um tíquete de impressão em um Modelo de Objeto XPS.

A interface IXpsOMPrintTicketResource permite que um programa leia o conteúdo de um tíquete de impressão existente chamando de método GetPrintTicketResource de uma interface que dá suporte a um tíquete de impressão. Novos recursos de tíquete de impressão podem ser adicionados em uma parte do documento chamando SetPrintTicketResource.

Existem três níveis de tíquete de impressão, que especificam o escopo do tíquete de impressão. Os níveis do tíquete de impressão são: o nível do trabalho (ou pacote), o nível do documento e o nível da página. A tabela a seguir mostra o relacionamento entre o nível do tíquete de impressão, a interface Modelo de Objeto XPS correspondente e os métodos utilizados para acessar o recurso do tíquete de impressão.

Nível do Tíquete de Impressão Interface Método Get Método Set
Trabalho :IXpsOMDocumentSequence GetPrintTicketResource SetPrintTicketResource
Documento :IXpsOMDocument GetPrintTicketResource SetPrintTicketResource
Page :IXpsOMPageReference GetPrintTicketResource SetPrintTicketResource

 

Conteúdo do Tíquete de Impressão

O conteúdo de um recurso de tíquete de impressão existente pode ser acessado por meio da leitura do fluxo associado ao recurso. O método GetStream da interface IXpsOMPrintTicketResource retorna o ponteiro para um fluxo somente leitura que contém o conteúdo formatado em XML do tíquete de impressão. O formato do conteúdo do tíquete de impressão está descrito na Especificação do Esquema de Impressão.

Um novo recurso de tíquete de impressão pode ser criado por meio da criação de uma nova interface IXpsOMPrintTicketResource. Um tíquete de impressão válido, formatado em XML, é gravado em um fluxo e um URI de parte é criado para identificar a parte do tíquete de impressão. Para obter mais informações sobre o conteúdo de um tíquete de impressão válido, confira Especificação do Esquema de Impressão. O streaming e o URI da parte são passados como parâmetros da chamada SetContent para definir o novo recurso de tíquete de impressão, e o recurso de tíquete de impressão é adicionado à parte do documento correspondente chamando o método SetPrintTicketResource mostrado na tabela anterior.

Os tíquetes de impressão herdam as propriedades dos tíquetes de impressão com escopo maior. Por exemplo, um tíquete de impressão no nível do documento herda as propriedades do tíquete de impressão no nível do trabalho que está associado à sequência de documentos do documento. Da mesma forma, um tíquete de impressão no nível da página herda as propriedades do tíquete de impressão no nível do documento que está associado ao documento da página. Nesse processo de herança, as propriedades especificadas no tíquete de impressão de nível inferior substituem as propriedades correspondentes que, de outra forma, seriam herdadas do tíquete de impressão de nível superior.

Especificação do Esquema de Impressão

:IXpsOMDocument

:IXpsOMDocumentSequence

:IXpsOMPageReference

:IXpsOMPrintTicketResource

XML Paper Specification