XPS OM 印刷チケット インターフェイス

  • [アーティクル]

XPS ドキュメント API のこの IXpsOMPrintTicketResource インターフェイスは、既存の印刷チケットへのアクセスと、XPS OM で印刷チケットを作成する機能を提供します。

IXpsOMPrintTicketResource インターフェイスを使用すると、プログラムは、印刷チケットをサポートするインターフェイスの GetPrintTicketResource メソッドを呼び出すことによって、既存の印刷チケットの内容を読み取ることができます。 SetPrintTicketResource を呼び出すことで、新しい印刷チケット リソースをドキュメント パーツに追加できます。

印刷チケットのスコープを指定する 3 つの印刷チケット レベルがあります。 印刷チケット レベルは、ジョブ (またはパッケージ) レベル、ドキュメント レベル、およびページ レベルです。 次の表は、印刷チケット レベル、対応する XPS OM インターフェイス、および印刷チケット リソースへのアクセスに使用されるメソッドの関係を示しています。

印刷チケット レベル インターフェイス Get メソッド Set メソッド
ジョブ IXpsOMDocumentSequence GetPrintTicketResource SetPrintTicketResource
ドキュメント IXpsOMDocument GetPrintTicketResource SetPrintTicketResource
ページ IXpsOMPageReference GetPrintTicketResource SetPrintTicketResource

 

チケットの内容を印刷する

既存の印刷チケット リソースのコンテンツには、リソースに関連付けられているストリームから読み取ることでアクセスできます。 IXpsOMPrintTicketResource インターフェイスの GetStream メソッドは、印刷チケットの XML 形式の内容を含む読み取り専用ストリームへのポインターを返します。 印刷チケットの内容の形式については、「印刷スキーマ仕様」を参照してください。

新しい印刷チケット リソースを作成するには、新しい IXpsOMPrintTicketResource インターフェイスを作成します。 有効な XML 形式の印刷チケットがストリームに書き込まれ、印刷チケット パーツを識別するためにパーツ URI が作成されます。 有効な印刷チケットの内容の詳細については、「印刷スキーマ仕様」を参照してください。 ストリームとパーツ URI は、新しい印刷チケット リソースを設定する SetContent 呼び出しのパラメーターとして渡され、印刷チケット リソースは、前の表に示す SetPrintTicketResource メソッドを呼び出すことによって、対応するドキュメント パーツに追加されます。

印刷チケットは、より大きな範囲の印刷チケットのプロパティを継承します。 たとえば、ドキュメント レベルの印刷チケットは、ドキュメントのドキュメント シーケンスに関連付けられているジョブ レベルの印刷チケットのプロパティを継承します。 同様に、ページ レベルの印刷チケットは、ページのドキュメントに関連付けられているドキュメント レベルの印刷チケットのプロパティを継承します。 この継承プロセスでは、下位レベルの印刷チケットで指定されたプロパティは、それ以外の場合は上位レベルの印刷チケットから継承される対応するプロパティをオーバーライドします。

印刷スキーマの仕様

IXpsOMDocument

IXpsOMDocumentSequence

IXpsOMPageReference

IXpsOMPrintTicketResource

XML Paper Specification