PrintTaskOptions Clase

Definición

Espacio de nombres:

Windows.Graphics.Printing

Representa una colección de métodos y propiedades para administrar las opciones que definen cómo se va a imprimir el contenido.

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

Herencia

Object Platform::Object IInspectable PrintTaskOptions

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

IPrintTaskOptionsCore IPrintTaskOptionsCoreProperties IPrintTaskOptionsCoreUIConfiguration

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

La clase PrintTaskOptions proporciona acceso a los diferentes valores que definen cómo se va a dar formato al contenido de la tarea de impresión durante la impresión. El objeto PrintTaskOptions puede contener información como el tamaño de la página impresa, su orientación y el tipo de medio en el que se imprimirá el contenido. Además, el objeto PrintTaskOptions proporciona acceso a la lista de opciones que se mostrarán en la ventana de impresión.

Aunque cada opción de PrintTaskOptions, por ejemplo MediaSize o MediaType, tiene un conjunto específico de valores admitidos, todas las opciones admiten el mismo patrón general para representar algunos casos comunes. Los valores de caso comunes son Default, NotAvailable e PrinterCustom.

Cada opción contiene un valor predeterminado y es el valor asignado a la opción por el destino de impresión. Cuando este valor se recupera a través de un acceso a propiedades, es una indicación de que el destino de impresión aún no ha determinado el valor real de esta opción. Al establecer el valor predeterminado para una opción determinada, indica al destino de impresión que debe usar el valor predeterminado que tiene para esa opción. Si no hay ningún valor predeterminado para esa opción, el valor de la opción no cambia.

Una opción también puede notificar un valor NotAvailable . Esto indica que la opción específica no está disponible para el destino de impresión seleccionado actualmente. Por ejemplo, si la propiedad Duplex devuelve un valor NotAvailable , indica que el destino de impresión no admite la funcionalidad dúplex. No es posible establecer una opción en el valor NotAvailable .

El valor final que es común a todas las opciones es PrinterCustom. Esto indica que el destino de impresión admite la funcionalidad, pero la selección actual es personalizada para esta impresora. Por ejemplo, un destino de impresión puede admitir un método especial para enlazar el documento que no es uno de los valores estándar. En este caso, una consulta de propiedad en la opción Binding devolverá el valor PrinterCustom . Los tamaños de salida personalizados también se representarán como valores PrinterCustom , pero los tamaños físicos reales seguirán estando disponibles a través del método GetPageDescription .

Una aplicación también puede usar PrintTaskOptions para personalizar las opciones que aparecen en la ventana de impresión. La propiedad DisplayedOptions devuelve un vector que contiene la lista de elementos de opción que se mostrarán. Las modificaciones en esta lista mediante la inserción, anexión, eliminación o reordenación de opciones se reflejarán en la ventana de impresión. Si un destino de impresión determinado no admite una opción, la opción no se mostrará al usuario. Para conocer los nombres de las opciones estándar, consulte StandardPrintTaskOptions.

Este es un fragmento de código que puede usar, por ejemplo, para establecer la salida impresa en color y también para establecer el tamaño del medio en el que se puede imprimir. Se PrintTaskOptions tiene acceso al objeto a través de la propiedad PrintTask.Options .

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

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

Para obtener más información sobre los valores permitidos para estas opciones de tarea de impresión, vea PrintColorMode e PrintMediaSize.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	Bordeando
1607	14393	GetPagePrintTicket
1803	17134	CustomPageRanges
1803	17134	PageRangeOptions

Propiedades

Binding	Obtiene o establece la opción de enlace para la tarea de impresión.
Bordering	Obtiene o establece la opción de borde de la tarea de impresión.
Collation	Obtiene o establece la opción de intercalación de las tareas de impresión.
ColorMode	Obtiene o establece la opción de modo de color de la tarea de impresión.
CustomPageRanges	Obtiene las opciones de intervalo de páginas personalizadas para la tarea de impresión.
DisplayedOptions	Obtiene la lista de opciones que se muestran para la experiencia de impresión.
Duplex	Obtiene o establece la opción dúplex de la tarea de impresión.
HolePunch	Obtiene o establece la opción de perforación del agujero de la tarea de impresión.
MaxCopies	Obtiene el número máximo de copias admitidas para la tarea de impresión.
MediaSize	Obtiene o establece la opción de tamaño multimedia de la tarea de impresión.
MediaType	Obtiene o establece la opción de tipo de medio para la tarea de impresión.
MinCopies	Obtiene el número mínimo de copias permitidas para la tarea de impresión.
NumberOfCopies	Obtiene o establece el valor del número de copias de la tarea de impresión.
Orientation	Obtiene o establece la opción de orientación para la tarea de impresión.
PageRangeOptions	Obtiene las opciones del intervalo de páginas para la tarea de impresión.
PrintQuality	Obtiene o establece la opción de calidad de impresión para la tarea de impresión.
Staple	Obtiene o establece la opción de grapa para la tarea de impresión.

Métodos

GetPageDescription(UInt32)	Recupera las dimensiones físicas de la página impresa.
GetPagePrintTicket(PrintPageInfo)	Recupera las dimensiones físicas y los datos de formato de una página impresa.

Consulte también

• PrintColorMode
• PrintMediaSize
• StandardPrintTaskOptions