OutputColor Enumeração

Definição

Especifica como imprimir conteúdos que contenham cor ou tons de cinzento.

public enum class OutputColor
public enum OutputColor
type OutputColor = 
Public Enum OutputColor
Herança
OutputColor

Campos

Name Valor Description
Unknown 0

A característica (cujas opções são representadas por esta enumeração) é definida para uma opção não definida no Esquema de Impressão.

Color 1

Saída que imprime a cores.

Grayscale 2

Saída que imprime em tons de cinzento.

Monochrome 3

Saída que imprime numa única cor e com o mesmo grau de intensidade.

Exemplos

O exemplo seguinte mostra como usar esta enumeração para definir PrintTicket valores.

// Use different PrintTickets for different FixedDocuments.
PrintTicket ptFD = new PrintTicket();

if (_firstDocumentPrintTicket <= 1)
{   // Print the first document in black/white and in portrait
    // orientation.  Since the PrintTicket at the
    // FixedDocumentSequence level already specifies portrait
    // orientation, this FixedDocument can just inherit that
    // setting without having to set it again.
    ptFD.PageOrientation = PageOrientation.Portrait;
    ptFD.OutputColor = OutputColor.Monochrome;
    _firstDocumentPrintTicket++;
}

else // if (_firstDocumentPrintTicket > 1)
{   // Print the second document in color and in landscape
    // orientation.  Since the PrintTicket at the
    // FixedDocumentSequence level already specifies portrait
    // orientation, this FixedDocument needs to set its
    // PrintTicket with landscape orientation in order to
    // override the higher level setting.
    ptFD.PageOrientation = PageOrientation.Landscape;
    ptFD.OutputColor = OutputColor.Color;
}
' Use different PrintTickets for different FixedDocuments.
Dim ptFD As New PrintTicket()

If _firstDocumentPrintTicket <= 1 Then
    ' orientation.  Since the PrintTicket at the
    ' FixedDocumentSequence level already specifies portrait
    ' orientation, this FixedDocument can just inherit that
    ' setting without having to set it again.
    ptFD.PageOrientation = PageOrientation.Portrait
    ptFD.OutputColor = OutputColor.Monochrome
    _firstDocumentPrintTicket += 1

Else ' if (_firstDocumentPrintTicket > 1)
    ' orientation.  Since the PrintTicket at the
    ' FixedDocumentSequence level already specifies portrait
    ' orientation, this FixedDocument needs to set its
    ' PrintTicket with landscape orientation in order to
    ' override the higher level setting.
    ptFD.PageOrientation = PageOrientation.Landscape
    ptFD.OutputColor = OutputColor.Color
End If

Observações

Use os valores deste tipo para estes fins:

  • Como membros da OutputColorCapability coleção, que é uma propriedade de PrintCapabilities, estes valores especificam os tipos de saída que uma impressora suporta. (Muitas impressoras suportam mais do que um tipo.)

  • Como o valor da OutputColor propriedade de um PrintTicket, eles direcionam a impressora para produzir o tipo designado de saída.

O valor Desconhecido nunca é usado nas propriedades dos PrintCapabilities objetos.

Nunca deve definir uma PrintTicket propriedade como Unknown. Se alguma outra PrintTicket aplicação produtora criou um documento PrintTicket que define a característica de cor de saída para uma opção não reconhecida (ou seja, uma opção não definida no Esquema de Impressão), então um PrintTicket objeto na sua aplicação construído com esse documento terá Unknown como valor da OutputColor propriedade.

Embora as PrintTicket classes and PrintCapabilities não possam ser herdadas, pode estender o Esquema de Impressão para reconhecer funcionalidades de dispositivos de impressão que não estão contabilizadas nas PrintTicket classes ou.PrintCapabilities Para mais informações, veja Como: Estender o Esquema de Impressão e Criar Novas Classes do Sistema de Impressão.

Aplica-se a

Ver também