PrintTicket.OutputColor Eigenschaft

Referenz

Definition

Namespace:: System.Printing

Assembly:: ReachFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, wie der Drucker Farben oder Graustufen verarbeitet, oder legt diesen fest.

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)

Eigenschaftswert

Nullable<OutputColor>

Ein OutputColor-Wert, der angibt, wie der Drucker Farben oder Graustufen verarbeitet.

Ausnahmen

ArgumentOutOfRangeException

In einem aufrufenden Code wurde versucht, die Eigenschaft auf einen Wert festzulegen, der nicht in der OutputColor-Enumeration vorhanden ist.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Eigenschaft verwenden, um einen Druckauftrag zu konfigurieren.

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

Hinweise

Ein null Wert für diese Eigenschaft bedeutet, dass diese Featureeinstellung nicht angegeben ist. Wenn der Wert ist null, enthalten die XML-Versionen von PrintTicket (siehe SaveTo und GetXmlStream) kein Markup für dieses Feature.

Diese Eigenschaft entspricht dem Schlüsselwort (keyword) des DruckschemasPageOutputColor.

Sie können die Vom Drucker unterstützten Optionen mithilfe der OutputColorCapability -Eigenschaft testen.

Gilt für:

Freigeben über