PrintTicket.OutputColor 属性

定义

获取或设置一个值,该值表示打印机如何处理包含颜色或灰影的内容。

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)

属性值

一个 OutputColor 值,表示打印机如何处理包含颜色或灰影的内容。

例外

调用代码操作尝试将属性设置为不在 OutputColor 枚举范围内的值。

示例

以下示例演示如何使用此属性来配置打印作业。

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

注解

null此属性的值表示未指定此功能设置。 此外,当值为 null时, (的 XML 版本 PrintTicket 将看不到 SaveToGetXmlStream) 将不包含此功能的任何标记。

此属性对应于打印架构PageOutputColor关键字 (keyword) 。

可以使用 属性测试打印机支持 OutputColorCapability 的选项。

适用于