Compartilhar via


Interfaces de tíquete de impressão de OM do XPS

Este interface IXpsOMPrintTicketResource da API de Documento XPS fornece acesso a um tíquete de impressão existente e também à capacidade de criar um tíquete de impressão em um OM XPS.

A interfaceIXpsOMPrintTicketResourcepermite que um programa leia o conteúdo de um tíquete de impressão existente chamando o 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 a uma parte do documento chamando SetPrintTicketResource.

Há 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 a relação entre o nível do tíquete de impressão, a interface OM do XPS correspondente e os métodos usados para acessar o recurso de tíquete de impressão.

Imprimir Nível de Tíquete Interface Método Get Método Set
Trabalho IXpsOMDocumentSequence GetPrintTicketResource SetPrintTicketResource
Documento IXpsOMDocument GetPrintTicketResource SetPrintTicketResource
Página IXpsOMPageReference GetPrintTicketResource SetPrintTicketResource

 

O conteúdo de um recurso de tíquete de impressão existente pode ser acessado lendo 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 é descrito no de Especificação do Esquema de Impressão.

Um novo recurso de tíquete de impressão pode ser criado criando um novo interface de 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, consulte o especificação de esquema de impressão. O fluxo 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 maior escopo. 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 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 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 de esquema de impressão

IXpsOMDocument

IXpsOMDocumentSequence

IXpsOMPageReference

IXpsOMPrintTicketResource

de especificação de papel XML