PrintTaskOptions Classe

Definição

Namespace:

Windows.Graphics.Printing

Representa uma coleção de métodos e propriedades para gerenciar as opções que definem como o conteúdo deve ser impresso.

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

Herança

Object Platform::Object IInspectable PrintTaskOptions

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IPrintTaskOptionsCore IPrintTaskOptionsCoreProperties IPrintTaskOptionsCoreUIConfiguration

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

A classe PrintTaskOptions fornece acesso aos diferentes valores que definem como o conteúdo na tarefa de impressão deve ser formatado durante a impressão. O objeto PrintTaskOptions pode conter informações como o tamanho da página impressa, sua orientação e o tipo de mídia na qual o conteúdo será impresso. Além disso, o objeto PrintTaskOptions fornece acesso à lista de opções a serem exibidas na janela de impressão.

Embora cada opção em PrintTaskOptions, por exemplo MediaSize ou MediaType, tenha um conjunto específico de valores com suporte, todas as opções dão suporte ao mesmo padrão geral para representar alguns casos comuns. Os valores de maiúsculas e minúsculas comuns são Default, NotAvailable e PrinterCustom.

Cada opção contém um valor padrão e é o valor atribuído à opção pelo destino de impressão. Quando esse valor é recuperado por meio de um acesso à propriedade, é uma indicação de que o destino de impressão ainda não determinou o valor real para essa opção. Quando você define o valor padrão para uma opção específica, ele indica para o destino de impressão que ele deve usar o valor padrão que ele tem para essa opção. Se não houver nenhum valor padrão para essa opção, o valor da opção permanecerá inalterado.

Uma opção também pode relatar um valor Não Disponível . Isso indica que a opção específica não está disponível para o destino de impressão selecionado no momento. Por exemplo, se a propriedade Duplex retornar um valor NotAvailable , ela indicará que o destino de impressão não dá suporte à funcionalidade duplex. Não é possível definir uma opção para o valor Não Disponível .

O valor final que é comum a todas as opções é PrinterCustom. Isso indica que o destino de impressão dá suporte à funcionalidade, mas a seleção atual é personalizada para essa impressora. Por exemplo, um destino de impressão pode dar suporte a um método especial para associar o documento que não é um dos valores padrão. Nesse caso, uma consulta de propriedade na opção Binding retornará o valor PrinterCustom . Os tamanhos de saída personalizados também serão representados como valores PrinterCustom , mas os tamanhos físicos reais ainda estarão disponíveis por meio do método GetPageDescription .

Um aplicativo também pode usar PrintTaskOptions para personalizar as opções que aparecem na janela de impressão. A propriedade DisplayedOptions retorna um vetor que contém a lista de itens de opção que serão exibidos. As modificações nessa lista inserindo, acrescentando, removendo ou reordenando opções serão refletidas na janela de impressão. Se um destino de impressão específico não der suporte a uma opção, a opção não será exibida para o usuário. Para obter os nomes das opções padrão, consulte StandardPrintTaskOptions.

Aqui está um snippet de código que você pode usar, por exemplo, para definir a saída impressa como cor e também para definir o tamanho da mídia na qual ela pode ser impressa. O PrintTaskOptions objeto é acessado por meio da propriedade PrintTask.Options .

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

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

Para obter mais informações sobre os valores permitidos para essas opções de tarefa de impressão, consulte PrintColorMode e PrintMediaSize.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	Limitando
1607	14393	GetPagePrintTicket
1803	17134	CustomPageRanges
1803	17134	PageRangeOptions

Propriedades

Binding	Obtém ou define a opção de associação para a tarefa de impressão.
Bordering	Obtém ou define a opção de borda para a tarefa de impressão.
Collation	Obtém ou define a opção de ordenação das tarefas de impressão.
ColorMode	Obtém ou define a opção de modo de cor da tarefa de impressão.
CustomPageRanges	Obtém as opções de intervalo de páginas personalizadas para a tarefa de impressão.
DisplayedOptions	Obtém a lista de opções exibidas para a experiência de impressão.
Duplex	Obtém ou define a opção duplex da tarefa de impressão.
HolePunch	Obtém ou define a opção de furo da tarefa de impressão.
MaxCopies	Obtém o número máximo de cópias com suporte para a tarefa de impressão.
MediaSize	Obtém ou define a opção de tamanho de mídia da tarefa de impressão.
MediaType	Obtém ou define a opção de tipo de mídia para a tarefa de impressão.
MinCopies	Obtém o número mínimo de cópias permitidas para a tarefa de impressão.
NumberOfCopies	Obtém ou define o valor do número de cópias para a tarefa de impressão.
Orientation	Obtém ou define a opção de orientação para a tarefa de impressão.
PageRangeOptions	Obtém as opções de intervalo de páginas para a tarefa de impressão.
PrintQuality	Obtém ou define a opção de qualidade de impressão para a tarefa de impressão.
Staple	Obtém ou define a opção de grampo para a tarefa de impressão.

Métodos

GetPageDescription(UInt32)	Recupera as dimensões físicas da página impressa.
GetPagePrintTicket(PrintPageInfo)	Recupera as dimensões físicas e os dados de formatação de uma página impressa.

Confira também

• PrintColorMode
• PrintMediaSize
• StandardPrintTaskOptions