PrintTaskConfiguration Klasse

Referenz

Definition

Namespace:: Windows.Devices.Printers.Extensions

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ermöglicht es einem Client, den Kontext der Druckaufgabenerweiterung abzurufen und der Druckaufgabe einen Ereignishandler hinzuzufügen.

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

Vererbung: Object Platform::Object IInspectable PrintTaskConfiguration

Attribute: ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows Desktop Extension SDK (eingeführt in 10.0.10240.0)
API contract	Windows.Devices.Printers.Extensions.ExtensionsContract (eingeführt in v1.0)

Hinweise

Wenn eine UWP-App über Weitere Einstellungen im Druckfenster aufgerufen wird, stellt das Aktivierungsereignis ein Ereignisargument vom Typ Windows.UI.WebUIPrintTaskSettingsActivatedEventArgs bereit, das die Eigenschaft Configuration zum Steuern des Druckers verfügbar macht. Diese Eigenschaft stellt ein Objekt vom Typ PrintTaskConfiguration bereit, das Zugriff auf den Kontext der Druckaufgabenerweiterung bietet, und ermöglicht es Ihnen auch, einen Ereignishandler hinzuzufügen, um das Druckticket zu aktualisieren.

Der folgende JavaScript-Codeausschnitt veranschaulicht, wie Auf das PrintTaskConfiguration-Objekt zugegriffen und dann für den Zugriff auf die PrinterExtensionContext-Eigenschaft verwendet wird.

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
}

Eigenschaften

PrinterExtensionContext

Ruft den Kontext für die Drucktaskerweiterung ab.

Ereignisse

SaveRequested

Wird durch das Druckfenster für Ihre App ausgelöst, um die Geräte-App zu benachrichtigen, dass das Druckticket aktualisiert werden muss.

Gilt für:

Weitere Informationen

PrinterExtensionContext

Freigeben über