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 应用时,激活事件将提供类型为 Windows.UI.WebUI.WebUIPrintTaskSettingsActivatedEventArgs 的事件参数,该参数公开属性 Configuration,用于控制打印机。 此属性提供 类型为 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

由应用的打印窗口引发,以通知设备应用必须更新打印票证。

适用于

另请参阅