Teilen über


OutputColor Enumeration

Definition

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

public enum class OutputColor
public enum OutputColor
type OutputColor = 
Public Enum OutputColor
Vererbung
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

Im folgenden Beispiel wird gezeigt, wie Diese Enumeration zum Festlegen PrintTicket von Werten verwendet wird.

// 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 die folgenden 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 PrintTicketweisen sie den Drucker an, den angegebenen Ausgabetyp zu erzeugen.

Der Unknown-Wert wird nie in Eigenschaften von PrintCapabilities -Objekten verwendet.

Sie sollten niemals eine PrintTicket Eigenschaft auf Unknownfestlegen. Wenn eine andere PrintTicket produzierende Anwendung ein PrintTicket-Dokument erstellt hat, das die Ausgabefarbfunktion auf eine nicht erkannte Option festlegt (d. h. eine Option, die nicht im Druckschema definiert ist), hat ein PrintTicket Objekt in Ihrer Anwendung, das mit diesem Dokument Unknown erstellt wird, den Wert der OutputColor -Eigenschaft.

Obwohl die PrintTicket Klassen und PrintCapabilities nicht vererbt werden können, können Sie das Druckschema erweitern, um Druckgerätefeatures zu erkennen, die nicht in den PrintTicket Klassen oder PrintCapabilities berücksichtigt werden. Weitere Informationen finden Sie unter Vorgehensweise: Erweitern des Druckschemas und Erstellen neuer Drucksystemklassen.

Gilt für:

Weitere Informationen