PrintTicket.OutputColor Propiedad

Definición

Espacio de nombres:

System.Printing

Ensamblado:

ReachFramework.dll

Obtiene o establece un valor que indica cómo la impresora controla el contenido que tiene color o tonos de gris.

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 de propiedad

Nullable<OutputColor>

Un valor OutputColor que indica el modo en que la impresora controla el contenido que tiene color o tonos de gris.

Excepciones

ArgumentOutOfRangeException

El código de llamada ha intentado establecer la propiedad en un valor que no está en la enumeración OutputColor.

Ejemplos

En el ejemplo siguiente se muestra cómo usar esta propiedad para configurar un trabajo de impresión.

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

Comentarios

Un null valor para esta propiedad significa que no se especifica esta configuración de característica. Además, cuando el valor es null, las versiones XML de PrintTicket (vea SaveTo y GetXmlStream) no contendrán ningún marcado para esta característica.

Esta propiedad corresponde a la palabra clave del esquema de PageOutputColor impresión.

Puede probar las opciones que admite la impresora mediante la OutputColorCapability propiedad .