PrintTaskConfiguration Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Devices.Printers.Extensions

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Consente a un client di recuperare il contesto dell'estensione dell'attività di stampa e di aggiungere un gestore eventi all'attività di stampa.

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

Ereditarietà: Object Platform::Object IInspectable PrintTaskConfiguration

Attributi: ContractVersionAttribute

Requisiti Windows

Famiglia di dispositivi	Windows Desktop Extension SDK (è stato introdotto in 10.0.10240.0)
API contract	Windows.Devices.Printers.Extensions.ExtensionsContract (è stato introdotto in v1.0)

Commenti

Quando un'app UWP viene richiamata da Altre impostazioni nella finestra di stampa, l'evento di attivazione fornisce un argomento evento di tipo Windows.UI.WebUI.WebUIPrintTaskSettingsActivatedEventArgs che espone una proprietà, Configuration, per controllare la stampante. Questa proprietà fornisce un oggetto di tipo PrintTaskConfiguration che fornisce l'accesso al contesto dell'estensione dell'attività di stampa e consente anche di aggiungere un gestore eventi per aggiornare il ticket di stampa.

Il frammento di codice JavaScript seguente illustra come accedere all'oggetto PrintTaskConfiguration e quindi usarlo per accedere alla proprietà 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
}

Proprietà

PrinterExtensionContext

Ottiene il contesto per l'estensione dell'attività di stampa.

Eventi

SaveRequested

Generato dalla finestra di stampa per l'app per notificare all'app per dispositivo che il ticket di stampa deve essere aggiornato.

Si applica a

Vedi anche

PrinterExtensionContext

Condividi tramite