PrintTaskOptions Klasse

Referenz

Definition

Namespace:: Windows.Graphics.Printing

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

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: ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert: IPrintTaskOptionsCore IPrintTaskOptionsCoreProperties IPrintTaskOptionsCoreUIConfiguration

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:

Freigeben über