PrintTaskConfiguration クラス

定義

クライアントが印刷タスク拡張コンテキストを取得し、印刷タスクにイベント ハンドラーを追加できるようにします。

public ref class PrintTaskConfiguration sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Printers.Extensions.ExtensionsContract, 65536)]
class PrintTaskConfiguration final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Printers.Extensions.ExtensionsContract), 65536)]
public sealed class PrintTaskConfiguration
Public NotInheritable Class PrintTaskConfiguration
継承
Object Platform::Object IInspectable PrintTaskConfiguration
属性

Windows の要件

デバイス ファミリ
Windows Desktop Extension SDK (10.0.10240.0 で導入)
API contract
Windows.Devices.Printers.Extensions.ExtensionsContract (v1.0 で導入)

注釈

印刷ウィンドウの [その他の設定] から UWP アプリが呼び出されると、ライセンス認証イベントは、プリンターを制御するためのプロパティ Configuration を公開する Windows.UI.WebUI.WebUIPrintTaskSettingsActivatedEventArgs 型のイベント引数を提供します。 このプロパティは、印刷タスク拡張コンテキストへのアクセスを提供する PrintTaskConfiguration 型のオブジェクトを提供します。また、印刷チケットを更新するイベント ハンドラーを追加することもできます。

次の JavaScript コード スニペットは、 PrintTaskConfiguration オブジェクトにアクセスし、それを使用して PrinterExtensionContext プロパティにアクセスする方法を示しています。

var configuration;
var printerExtesionContext;

function displayPrintSettings() {

    if (!configuration) {
        sdkSample.displayError("Configuration argument is null");
        return;
    }

    printerExtesionContext = configuration.printerExtensionContext;
    printHelper = new Microsoft.Samples.Printing.WwaDca.
        PrintHelperClass(printerExtensionContext);    

    var feature = "PageOrientation";

    // if printer's capabilities include this feature.
    if (!printHelper.featureExists(feature)) {
        continue;
    }

    // Get the selected option for this feature in the current
    // context's print ticket.
    var selectedOption = printHelper.getSelectedOptionIndex(feature);

    // Get the array of options in the current context’s print ticket
    var optionIndex = printHelper.getOptionInfo(feature, "Index"),
    var optionNames = printHelper.getOptionInfo(feature, 
        "DisplayName"),

    var selectedName;
    for (var i = 0; i < optionIndex.length; i++) {
        if (optionIndex[i] === selectedOption)
           selectedName = optionNames[i];

    // logic to display the orientation string here
}

プロパティ

PrinterExtensionContext

印刷タスク拡張機能のコンテキストを取得します。

イベント

SaveRequested

印刷チケットを更新する必要があることをデバイス アプリに通知するために、アプリの印刷ウィンドウによって発生します。

適用対象

こちらもご覧ください