PrintTaskConfiguration Classe

Definição

Namespace:

Windows.Devices.Printers.Extensions

Permite que um cliente recupere o contexto de extensão de tarefa de impressão e também adicione um manipulador de eventos à tarefa de impressão.

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

Herança

Object Platform::Object IInspectable PrintTaskConfiguration

Atributos

ContractVersionAttribute

Requisitos do Windows

Família de dispositivos	Windows Desktop Extension SDK (introduzida na 10.0.10240.0)
API contract	Windows.Devices.Printers.Extensions.ExtensionsContract (introduzida na v1.0)

Comentários

Quando um aplicativo UWP é invocado de Mais configurações na janela de impressão, o evento de ativação fornece um argumento de evento do tipo Windows.UI.WebUI.WebUIPrintTaskSettingsActivatedEventArgs que expõe uma propriedade, Configuration, para controlar a impressora. Essa propriedade fornece um objeto do tipo PrintTaskConfiguration que fornece acesso ao contexto de extensão de tarefa de impressão e também permite que você adicione um manipulador de eventos para atualizar o tíquete de impressão.

O snippet de código JavaScript a seguir demonstra como acessar o objeto PrintTaskConfiguration e, em seguida, usá-lo para acessar a propriedade 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
}

Propriedades

PrinterExtensionContext

Obtém o contexto da extensão de tarefa de impressão.

Eventos

SaveRequested

Gerado pela janela de impressão do aplicativo para notificar o aplicativo do dispositivo de que o tíquete de impressão deve ser atualizado.

Confira também

• PrinterExtensionContext