Поделиться через


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

Вызывается окном печати для вашего приложения, чтобы уведомить приложение устройства о необходимости обновления билета на печать.

Применяется к

См. также раздел