Freigeben über


OutputColor Enumeration

Definition

Gibt an, wie Inhalte gedruckt werden, die Farben oder Grautöne enthalten.

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

Felder

Name Wert Beschreibung
Unknown 0

Das Feature (dessen Optionen durch diese Enumeration dargestellt werden) wird auf eine Option festgelegt, die im Druckschema nicht definiert ist.

Color 1

Ausgabe, die in Farbe gedruckt wird.

Grayscale 2

Ausgabe, die in einer Graustufen gedruckt wird.

Monochrome 3

Ausgabe, die in einer einzigen Farbe und mit demselben Intensitätsgrad gedruckt wird.

Beispiele

Das folgende Beispiel zeigt, 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 diese Zwecke:

  • Als Elemente der Auflistung, bei der OutputColorCapability es sich um eine Eigenschaft handelt PrintCapabilities, geben diese Werte die Ausgabetypen an, die ein Drucker unterstützt. (Viele Drucker unterstützen mehrere Typen.)

  • Als Wert der OutputColor Eigenschaft eines PrintTicketDruckers 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 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), dann weist ein PrintTicket Objekt in Ihrer Anwendung, das mit diesem Dokument Unknown erstellt wird, als Wert der OutputColor Eigenschaft auf.

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

Gilt für:

Weitere Informationen