PrintTaskOptions Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, IPrintTaskOptionsCoreUIConfigurationPublic NotInheritable Class PrintTaskOptions
Implements IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration- Herança
- Atributos
- Implementações
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. |