Compartir a través de


PrintTaskConfiguration Clase

Definición

Permite a un cliente recuperar el contexto de extensión de tarea de impresión y también agregar un controlador de eventos a la tarea de impresión.

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
Herencia
Object Platform::Object IInspectable PrintTaskConfiguration
Atributos

Requisitos de Windows

Familia de dispositivos
Windows Desktop Extension SDK (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Devices.Printers.Extensions.ExtensionsContract (se introdujo en la versión v1.0)

Comentarios

Cuando se invoca una aplicación para UWP desde Más opciones de configuración en la ventana de impresión, el evento de activación proporciona un argumento de evento de tipo Windows.UI.WebUI.WebUIPrintTaskSettingsActivatedEventArgs que expone una propiedad, Configuration, para controlar la impresora. Esta propiedad proporciona un objeto de tipo PrintTaskConfiguration que proporciona acceso al contexto de extensión de tarea de impresión y también permite agregar un controlador de eventos para actualizar el vale de impresión.

El siguiente fragmento de código javaScript muestra cómo obtener acceso al objeto PrintTaskConfiguration y, a continuación, usarlo para tener acceso a la propiedad 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
}

Propiedades

PrinterExtensionContext

Obtiene el contexto de la extensión de tarea de impresión.

Eventos

SaveRequested

Generada por la ventana de impresión de la aplicación para notificar a la aplicación de dispositivo que se debe actualizar el vale de impresión.

Se aplica a

Consulte también