PrintTicket.OutputColor Propriedade

Definição

Namespace:

System.Printing

Assembly:

ReachFramework.dll

Obtém ou define um valor que indica como a impressora trata conteúdos com cor ou tons de cinza.

public:
 property Nullable<System::Printing::OutputColor> OutputColor { Nullable<System::Printing::OutputColor> get(); void set(Nullable<System::Printing::OutputColor> value); };

public System.Printing.OutputColor? OutputColor { get; set; }

member this.OutputColor : Nullable<System.Printing.OutputColor> with get, set

Public Property OutputColor As Nullable(Of OutputColor)

Valor da propriedade

Nullable<OutputColor>

Um valor OutputColor que indica como a impressora trata conteúdos com cor ou tons de cinza.

Exceções

ArgumentOutOfRangeException

O código de chamada tentou definir a propriedade com um valor que não está na enumeração OutputColor.

Exemplos

O exemplo a seguir mostra como usar essa propriedade para configurar um trabalho de impressão.

// 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

Um null valor para essa propriedade significa que essa configuração de recurso não está especificada. Além disso, quando o valor for null, as versões XML do PrintTicket (consulte SaveTo e GetXmlStream) não conterão nenhuma marcação para esse recurso.

Essa propriedade corresponde ao palavra-chave do Esquema de PageOutputColorImpressão.

Você pode testar as opções às quais a impressora dá suporte usando a OutputColorCapability propriedade .