OutputColor Enumeração

Definição

Especifica como imprimir o conteúdo que contém cores ou tons de cinza.

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

Campos

Color 1

Saída que é impressa colorida.

Grayscale 2

Saída que é impressa em uma escala de cinza.

Monochrome 3

Saída que é impressa em uma única cor e com o mesmo grau de intensidade.

Unknown 0

O recurso (cujas opções são representadas por essa enumeração) é definido como uma opção não definida no Esquema de Impressão.

Exemplos

O exemplo a seguir mostra como usar essa 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

Comentários

Use os valores desse tipo para estas finalidades:

  • Como membros da OutputColorCapability coleção, que é uma propriedade de PrintCapabilities, esses valores especificam os tipos de saída compatíveis com uma impressora. (Muitas impressoras dão suporte a mais de um tipo.)

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

O valor Unknown nunca é usado em propriedades de PrintCapabilities objetos .

Você nunca deve definir uma PrintTicket propriedade como Unknown. Se algum outro PrintTicket aplicativo de produção tiver criado um documento PrintTicket que define o recurso de cor de saída como uma opção não reconhecida (ou seja, uma opção que não está definida no Esquema de Impressão), um PrintTicket objeto em seu aplicativo construído com esse documento terá Unknown como o valor da OutputColor propriedade.

Embora as PrintTicket classes e PrintCapabilities não possam ser herdadas, você pode estender o Esquema de Impressão para reconhecer recursos de dispositivo de impressão que não são contabilizados nas PrintTicket classes ou PrintCapabilities . Para obter mais informações, consulte Como estender o esquema de impressão e Create novas classes do sistema de impressão.

Aplica-se a

Confira também