PrintTaskOptions Class

コンテンツの印刷方法を定義するオプションを管理するためのメソッドとプロパティのコレクションを表します。

構文


/* このオブジェクトの作成とアクセスについては、「解説」を参照してください。 */

属性

[MarshalingBehavior(Agile)]
[Muse()]
[Version(0x06020000)]

メンバー

PrintTaskOptionsクラス には次の種類のメンバーがあります。

メソッド

The PrintTaskOptions クラス には次のメソッドがあります。 With C#、Visual Basic、および C++ では、以下からもメソッドが継承されます。Object クラス.

メソッド説明
GetPageDescription Retrieves the physical dimensions of the printed page.

 

プロパティ

PrintTaskOptionsクラス には次のプロパティがあります。

プロパティアクセスの種類説明

Binding

読み取り/書き込みGets or sets the binding option for the print task.

Collation

読み取り/書き込みGets or sets the collation option of the print tasks.

ColorMode

読み取り/書き込みGets or sets the color mode option of the print task.

DisplayedOptions

読み取り専用Gets the list of options displayed for the print experience.

Duplex

読み取り/書き込みGets or sets the duplex option of the print task.

HolePunch

読み取り/書き込みGets or sets the hole punch option of the print task.

MaxCopies

読み取り専用Gets the maximum number of copies supported for the print task.

MediaSize

読み取り/書き込みGets or sets the media size option of the print task.

MediaType

読み取り/書き込みGets or sets the media type option for the print task.

MinCopies

読み取り専用Gets the minimum number of copies allowed for the print task.

NumberOfCopies

読み取り/書き込みGets or sets the value for the number of copies for the print task.

Orientation

読み取り/書き込みGets or sets the orientation option for the print task.

PrintQuality

読み取り/書き込みGets or sets the print quality option for the print task.

Staple

読み取り/書き込みGets or sets the staple option for the print task.

 

解説

PrintTaskOptions クラスは、印刷タスクのコンテンツが印刷時にどのようにフォーマットされるかを定義するさまざまな値へのアクセスを提供します。 PrintTaskOptions オブジェクトは、印刷されるページのサイズ、方向、およびコンテンツが印刷されるメディアのタイプなどの情報を含むことができます。 また、PrintTaskOptions オブジェクトは、印刷ウィンドウに表示されるオプションの一覧へのアクセスを提供します。

MediaSize や MediaType などの PrintTaskOptions 内の各オプションにはサポートされている値の特定のセットがありますが、すべてのオプションでは、共通の状況を表すための同じ一般的なパターンをサポートしています。 共通のケースの値は、DefaultNotAvailablePrinterCustom です。

各オプションには、印刷のターゲットによってオプションに割り当てられている値である既定値が含まれています。 この値がプロパティ アクセスによって取得されると、印刷対象によって、このオプションの実際の値が確認されていないことがわかります。 特定のオプションの既定値を設定する場合は、印刷対象に対し、そのオプションに既定値を使用する必要があることを示します。 このオプションに既定値がない場合、オプション値は変更されません。

オプションによって、NotAvailable 値が報告される場合もあります。 これは、現在選択済みの印刷対象では、特定のオプションが使用できないことを示します。 たとえば、Duplex プロパティが NotAvailable 値を返す場合、印刷対象が両面印刷機能をサポートしていないことを示します。 オプションを NotAvailable に設定することはできません。

すべてのオプションに共通の最終値は PrinterCustom です。 これは、印刷対象が機能をサポートしているが現在の選択がこのプリンターではカスタム設定であることを示してます。 たとえば、印刷対象が、標準値ではないドキュメントを束縛する場合の特別なメソッドをサポートする場合があります。 この場合、Binding オプションのプロパティ クエリは PrinterCustom 値を返します。 カスタムの出力のサイズは PrinterCustom 値でも表されますが、実際の物理サイズはまだ GetPageDescription メソッドによって使用できます。

アプリケーションでは、印刷ウィンドウに表示されるオプションをカスタマイズするために PrintTaskOptions も使用する場合があります。 DisplayedOptions プロパティは、表示される選択項目の一覧を含むベクターを返します。 オプションの挿入、追加、削除、または順序の変更によるこのリストへの変更は、印刷ウィンドウに反映されます。 特定の印刷対象がオプションをサポートしていない場合、このオプションはユーザーに表示されません。 標準的なオプションの名前については、「StandardPrintTaskOptions」を参照してください。

印刷出力をカラーに設定したり、印刷できるメディアのサイズを設定するためなどに使用できる JavaScript コード スニペットを次に示します。


// Set output to color
printTaskOptions.colorMode = colorMode;

// Set the media size for printing
printTaskOptions.mediaSize = mediaSize;


これらの印刷タスク オプションで使用できる値の詳細については、「PrintColorMode」と「PrintMediaSize」を参照してください。

要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

名前空間

Windows.Graphics.Printing
Windows::Graphics::Printing [C++]

メタデータ

Windows.winmd

参照

PrintColorMode
PrintMediaSize
StandardPrintTaskOptions
Windows.Graphics.Printing 列挙値

 

 

表示:
© 2014 Microsoft