OutputColor 枚举

定义

命名空间:

System.Printing

程序集:

ReachFramework.dll

指定如何打印包含彩色或灰阶的内容。

public enum class OutputColor

public enum OutputColor

type OutputColor = 

Public Enum OutputColor

继承

Object

ValueType

Enum

OutputColor

字段

Color	1	彩色打印输出。
Grayscale	2	灰度打印输出。
Monochrome	3	以单色打印且具有相同亮度的输出。
Unknown	0	该功能（其选项由此枚举表示）设置为未在 打印架构中定义的选项。

示例

以下示例演示如何使用此枚举来设置 PrintTicket 值。

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

注解

使用此类型的值用于以下目的：

• 这些值作为 集合的成员 OutputColorCapability （即 的属性 PrintCapabilities）指定打印机支持的输出类型。 (许多打印机支持多个类型。)

• 作为 的 PrintTicket属性的值OutputColor，它们指示打印机生成指定类型的输出。

未知值永远不会在 对象的属性PrintCapabilities中使用。

切勿将 PrintTicket 属性设置为 Unknown。 如果其他 PrintTicket 某个生成应用程序创建了一个 PrintTicket 文档 ，该文档将输出颜色功能设置为无法识别的选项 (即打印 架构) 中未定义的选项，则 PrintTicket 应用程序中使用该文档构造的对象将具有 Unknown 作为 属性的值 OutputColor 。

PrintTicket尽管 无法继承 和 PrintCapabilities 类，但你可以扩展打印架构以识别 未在 或 PrintCapabilities 类中PrintTicket考虑的打印设备功能。 有关详细信息 ，请参阅如何：扩展打印架构和创建新的打印系统类。

另请参阅

• PrintCapabilities
• PrintTicket