PrintTaskConfiguration Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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. |