PrintTaskOptions クラス

定義

public ref class PrintTaskOptions sealed : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PrintTaskOptions final : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PrintTaskOptions : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

Public NotInheritable Class PrintTaskOptions
Implements IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

継承

Object Platform::Object IInspectable PrintTaskOptions

属性

ContractVersionAttribute MarshalingBehaviorAttribute

実装

IPrintTaskOptionsCore IPrintTaskOptionsCoreProperties IPrintTaskOptionsCoreUIConfiguration

Windows の要件

注釈

PrintTaskOptions クラスは、印刷時に印刷タスク内のコンテンツを書式設定する方法を定義するさまざまな値にアクセスできます。 PrintTaskOptions オブジェクトには、印刷されるページのサイズ、その向き、コンテンツを印刷するメディアの種類などの情報が含まれる場合があります。 さらに、PrintTaskOptions オブジェクトを使用すると、印刷ウィンドウに表示されるオプションの一覧にアクセスできます。

PrintTaskOptions の各オプション ( MediaSize や MediaType など) には、サポートされている値の特定のセットが含まれていますが、すべてのオプションは、一般的なケースを表すのと同じ一般的なパターンをサポートします。 一般的なケース値は 、Default、 NotAvailable 、 PrinterCustom です。

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

オプションでは、 NotAvailable 値を報告することもできます。 これは、現在選択されている印刷ターゲットに対して特定のオプションを使用できない場合を示します。 たとえば、Duplex プロパティが NotAvailable 値を返す場合、印刷先が双方向機能をサポートしていないことを示します。 オプションを NotAvailable 値に設定することはできません。

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

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

印刷された出力を色に設定したり、印刷できるメディアのサイズを設定したりするために使用できるコード スニペットを次に示します。 オブジェクトには PrintTaskOptions 、 PrintTask.Options プロパティを使用してアクセスします。

// Set output to color
printTask.Options.ColorMode = PrintColorMode.Color;

// Set the media size for printing
printTask.Options.MediaSize = PrintMediaSize.NorthAmericaLegal;

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

バージョン履歴

プロパティ

メソッド

適用対象

こちらもご覧ください

• PrintColorMode
• PrintMediaSize
• StandardPrintTaskOptions