Partager via


PrintTaskConfiguration Classe

Définition

Permet à un client de récupérer le contexte d’extension de tâche d’impression et d’ajouter un gestionnaire d’événements à la tâche d’impression.

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
Héritage
Object Platform::Object IInspectable PrintTaskConfiguration
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows Desktop Extension SDK (introduit dans 10.0.10240.0)
API contract
Windows.Devices.Printers.Extensions.ExtensionsContract (introduit dans v1.0)

Remarques

Lorsqu’une application UWP est appelée à partir de Plus de paramètres dans la fenêtre d’impression, l’événement d’activation fournit un argument d’événement de type Windows.UI.WebUI.WebUIPrintTaskSettingsActivatedEventArgs qui expose une propriété, Configuration, pour contrôler l’imprimante. Cette propriété fournit un objet de type PrintTaskConfiguration qui fournit l’accès au contexte d’extension de tâche d’impression et vous permet également d’ajouter un gestionnaire d’événements pour mettre à jour le ticket d’impression.

L’extrait de code JavaScript suivant montre comment accéder à l’objet PrintTaskConfiguration , puis comment l’utiliser pour accéder à la propriété 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
}

Propriétés

PrinterExtensionContext

Obtient le contexte de l’extension de tâche d’impression.

Événements

SaveRequested

Déclenché par la fenêtre d’impression de votre application pour informer l’application d’appareil que le ticket d’impression doit être mis à jour.

S’applique à

Voir aussi