OutputColor Enumeration

  • Referenz

Definition

Namespace:
System.Printing
Assembly:
ReachFramework.dll

Gibt an, wie Inhalte gedruckt werden, die Farben oder Graustufen enthalten.

public enum class OutputColor
public enum OutputColor
type OutputColor = 
Public Enum OutputColor
Vererbung
Object
ValueType
Enum
OutputColor

Felder

Color 1

Die Ausgabe wird in Farbe gedruckt.
Grayscale 2

Die Ausgabe wird mit Graustufen gedruckt.
Monochrome 3

Die Ausgabe wird in einer einzelnen Farbe und gleichbleibender Intensität gedruckt.
Unknown 0

Für die Funktion (deren Optionen durch diese Enumeration dargestellt werden) wurde eine Option festgelegt, die im Druckschemanicht definiert ist.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Enumeration zum Festlegen PrintTicket von Werten verwenden.

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

Verwenden Sie die Werte dieses Typs für diese Zwecke:

  • Als Member der OutputColorCapability Auflistung, die eine Eigenschaft von PrintCapabilitiesist, geben diese Werte die Ausgabetypen an, die ein Drucker unterstützt. (Viele Drucker unterstützen mehrere Typen.)

  • Als Wert der OutputColor Eigenschaft eines PrintTicketObjekts leiten sie den Drucker an, um den angegebenen Ausgabetyp zu erzeugen.

Der Unbekannte Wert wird nie in Eigenschaften von PrintCapabilities Objekten verwendet.

Sie sollten niemals eine PrintTicket Eigenschaft Unknownauf festlegen. Wenn eine andere PrintTicket Produktionsanwendung ein PrintTicket-Dokument erstellt hat, das das Ausgabefarbfeature auf eine nicht erkannte Option festlegt (also eine Option, die im Druckschema nicht definiert ist), dann hat ein PrintTicket Objekt in Ihrer Anwendung, das mit diesem Dokument Unknown erstellt wird, als Wert der OutputColor Eigenschaft.

Obwohl die PrintTicket Klassen PrintCapabilities nicht geerbt werden können, können Sie das Druckschema erweitern, um Druckgerätefeatures zu erkennen, die in den PrintTicket Klassen PrintCapabilities nicht berücksichtigt werden. Weitere Informationen finden Sie unter How to: Extend the Print Schema and Create New Print System Classes.

Gilt für

Siehe auch