Freigeben über


PrintTaskOptions Klasse

Definition

Stellt eine Auflistung von Methoden und Eigenschaften zum Verwalten der Optionen dar, die definieren, wie der Inhalt gedruckt werden soll.

public ref class PrintTaskOptions sealed : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PrintTaskOptions final : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PrintTaskOptions : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration
Public NotInheritable Class PrintTaskOptions
Implements IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration
Vererbung
Object Platform::Object IInspectable PrintTaskOptions
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die PrintTaskOptions-Klasse bietet Zugriff auf die verschiedenen Werte, die definieren, wie der Inhalt des Drucktasks während des Druckvorgangs formatiert werden soll. Das PrintTaskOptions-Objekt kann Informationen wie die Größe der gedruckten Seite, ihre Ausrichtung und den Typ der Medien enthalten, auf denen der Inhalt gedruckt wird. Darüber hinaus bietet das PrintTaskOptions-Objekt Zugriff auf die Liste der Optionen, die im Druckfenster angezeigt werden sollen.

Während jede Option in PrintTaskOptions, z. B . MediaSize oder MediaType, über einen bestimmten Satz unterstützter Werte verfügt, unterstützen alle Optionen das gleiche allgemeine Muster für die Darstellung einiger gängiger Fälle. Die allgemeinen Groß-/Kleinschreibungswerte sind Default, NotAvailable und PrinterCustom.

Jede Option enthält einen Standardwert, und es ist der Wert, der der Option vom Druckziel zugewiesen wird. Wenn dieser Wert über einen Eigenschaftszugriff abgerufen wird, ist dies ein Hinweis darauf, dass das Druckziel den tatsächlichen Wert für diese Option noch nicht ermittelt hat. Wenn Sie den Standardwert für eine bestimmte Option festlegen, gibt er dem Druckziel an, dass es den Standardwert verwenden muss, den es für diese Option hat. Wenn für diese Option kein Standardwert vorhanden ist, bleibt der Optionswert unverändert.

Eine Option kann auch einen NotAvailable-Wert melden. Dies gibt an, dass die spezifische Option für das aktuell ausgewählte Druckziel nicht verfügbar ist. Wenn die Duplex-Eigenschaft beispielsweise einen NotAvailable-Wert zurückgibt, gibt dies an, dass das Druckziel keine Duplexfunktionalität unterstützt. Es ist nicht möglich, eine Option auf den Wert NotAvailable festzulegen.

Der endgültige Wert, der allen Optionen gemeinsam ist , ist PrinterCustom. Dies gibt an, dass das Druckziel die Funktionalität unterstützt, aber die aktuelle Auswahl für diesen Drucker angepasst ist. Beispielsweise kann ein Druckziel eine spezielle Methode zum Binden des Dokuments unterstützen, die nicht zu den Standardwerten gehört. In diesem Fall gibt eine Eigenschaftenabfrage für die Option Bindung den PrinterCustom-Wert zurück. Benutzerdefinierte Ausgabegrößen werden auch als PrinterCustom-Werte dargestellt, aber die tatsächlichen physischen Größen sind weiterhin über die GetPageDescription-Methode verfügbar.

Eine App kann auch PrintTaskOptions verwenden, um die Im Druckfenster angezeigten Optionen anzupassen. Die DisplayedOptions-Eigenschaft gibt einen Vektor zurück, der die Liste der Optionselemente enthält, die angezeigt werden. Änderungen an dieser Liste durch Einfügen, Anfügen, Entfernen oder Neureihenfolgen werden im Druckfenster widergespiegelt. Wenn ein bestimmtes Druckziel keine Option unterstützt, wird die Option dem Benutzer nicht angezeigt. Die Namen der Standardoptionen finden Sie unter StandardPrintTaskOptions.

Hier sehen Sie einen Codeausschnitt, mit dem Sie z. B. die gedruckte Ausgabe auf Farbe festlegen und die Größe des Mediums festlegen können, auf dem sie gedruckt werden kann. Auf PrintTaskOptions das Objekt wird über die PrintTask.Options-Eigenschaft zugegriffen.

// Set output to color
printTask.Options.ColorMode = PrintColorMode.Color;

// Set the media size for printing
printTask.Options.MediaSize = PrintMediaSize.NorthAmericaLegal;

Weitere Informationen zu den zulässigen Werten für diese Drucktaskoptionen finden Sie unter PrintColorMode und PrintMediaSize.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1607 14393 Angrenzenden
1607 14393 GetPagePrintTicket
1803 17134 CustomPageRanges
1803 17134 PageRangeOptions

Eigenschaften

Binding

Ruft die Bindungsoption für den Drucktask ab oder legt sie fest.

Bordering

Ruft die Randoption für den Drucktask ab oder legt diese fest.

Collation

Ruft die Sortierungsoption der Druckaufgaben ab oder legt diese fest.

ColorMode

Ruft die Farbmodusoption des Drucktasks ab oder legt diese fest.

CustomPageRanges

Ruft die benutzerdefinierten Seitenbereichsoptionen für den Drucktask ab.

DisplayedOptions

Ruft die Liste der Optionen ab, die für die Druckoberfläche angezeigt werden.

Duplex

Ruft die Duplexoption des Drucktasks ab oder legt diese fest.

HolePunch

Ruft die Lochstempeloption des Drucktasks ab oder legt diese fest.

MaxCopies

Ruft die maximale Anzahl von Kopien ab, die für den Drucktask unterstützt werden.

MediaSize

Ruft die Mediengröße-Option des Drucktasks ab oder legt diese fest.

MediaType

Ruft die Medientypoption für den Drucktask ab oder legt diese fest.

MinCopies

Ruft die Mindestanzahl von Kopien ab, die für den Drucktask zulässig sind.

NumberOfCopies

Ruft den Wert für die Anzahl der Kopien für den Drucktask ab oder legt den Wert fest.

Orientation

Ruft die Ausrichtungsoption für den Drucktask ab oder legt diese fest.

PageRangeOptions

Ruft die Seitenbereichsoptionen für den Drucktask ab.

PrintQuality

Ruft die Druckqualitätsoption für den Drucktask ab oder legt diese fest.

Staple

Ruft die Klammeroption für den Drucktask ab oder legt diese fest.

Methoden

GetPageDescription(UInt32)

Ruft die physischen Dimensionen der gedruckten Seite ab.

GetPagePrintTicket(PrintPageInfo)

Ruft die physischen Dimensionen und Formatierungsdaten einer gedruckten Seite ab.

Gilt für:

Weitere Informationen