PageSettings.Color 属性
获取或设置一个值,该值指示是否应以彩色打印该页。
**命名空间:**System.Drawing.Printing
**程序集:**System.Drawing(在 system.drawing.dll 中)
语法
声明
Public Property Color As Boolean
用法
Dim instance As PageSettings
Dim value As Boolean
value = instance.Color
instance.Color = value
public bool Color { get; set; }
public:
property bool Color {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_Color ()
/** @property */
public void set_Color (boolean value)
public function get Color () : boolean
public function set Color (value : boolean)
属性值
如果该页应以彩色打印,则为 true;反之,则为 false。默认值由打印机决定。
异常
异常类型 | 条件 |
---|---|
PrinterSettings.PrinterName 属性中命名的打印机不存在。 |
备注
可以使用 PrinterSettings.SupportsColor 属性确定打印机是否支持彩色打印。如果打印机支持彩色打印,但是您又不想彩色打印,请将 Color 属性设置为 false。默认值为 true。
示例
下面的代码示例打印文档并彩印文档的第一页(如果打印机支持该功能)。该示例要求已创建名为 printDoc
的 PrintDocument 变量,并且处理 PrintPage 和 QueryPageSettings 事件。
在此示例中使用 System.Drawing 和 System.Drawing.Printing 命名空间。
Private Sub MyButtonPrint_OnClick(ByVal sender As Object, ByVal e As System.EventArgs)
' Set the printer name and ensure it is valid. If not, provide a message to the user.
printDoc.PrinterSettings.PrinterName = "\\mynetworkprinter"
If printDoc.PrinterSettings.IsValid Then
' If the printer supports printing in color, then override the printer's default behavior.
if printDoc.PrinterSettings.SupportsColor then
' Set the page default's to not print in color.
printDoc.DefaultPageSettings.Color = False
End If
' Provide a friendly name, set the page number, and print the document.
printDoc.DocumentName = "My Presentation"
currentPageNumber = 1
printDoc.Print()
Else
MessageBox.Show("Printer is not valid")
End If
End Sub
Private Sub MyPrintQueryPageSettingsEvent(ByVal sender As Object, ByVal e As QueryPageSettingsEventArgs)
' Determines if the printer supports printing in color.
If printDoc.PrinterSettings.SupportsColor Then
' If the printer supports color printing, use color.
If currentPageNumber = 1 Then
e.PageSettings.Color = True
End If
End If
End Sub
private void MyButtonPrint_OnClick(object sender, System.EventArgs e)
{
// Set the printer name and ensure it is valid. If not, provide a message to the user.
printDoc.PrinterSettings.PrinterName = "\\mynetworkprinter";
if (printDoc.PrinterSettings.IsValid) {
// If the printer supports printing in color, then override the printer's default behavior.
if (printDoc.PrinterSettings.SupportsColor) {
// Set the page default's to not print in color.
printDoc.DefaultPageSettings.Color = false;
}
// Provide a friendly name, set the page number, and print the document.
printDoc.DocumentName = "My Presentation";
currentPageNumber = 1;
printDoc.Print();
}
else {
MessageBox.Show("Printer is not valid");
}
}
private void MyPrintQueryPageSettingsEvent(object sender, QueryPageSettingsEventArgs e)
{
// Determines if the printer supports printing in color.
if (printDoc.PrinterSettings.SupportsColor) {
// If the printer supports color printing, use color.
if (currentPageNumber == 1 ) {
e.PageSettings.Color = true;
}
}
}
private:
void MyButtonPrint_OnClick( Object^ sender, System::EventArgs^ e )
{
// Set the printer name and ensure it is valid. If not, provide a message to the user.
printDoc->PrinterSettings->PrinterName = "\\mynetworkprinter";
if ( printDoc->PrinterSettings->IsValid )
{
// If the printer supports printing in color, then override the printer's default behavior.
if ( printDoc->PrinterSettings->SupportsColor )
{
// Set the page default's to not print in color.
printDoc->DefaultPageSettings->Color = false;
}
// Provide a friendly name, set the page number, and print the document.
printDoc->DocumentName = "My Presentation";
currentPageNumber = 1;
printDoc->Print();
}
else
{
MessageBox::Show( "Printer is not valid" );
}
}
void MyPrintQueryPageSettingsEvent( Object^ sender, QueryPageSettingsEventArgs^ e )
{
// Determines if the printer supports printing in color.
if ( printDoc->PrinterSettings->SupportsColor )
{
// If the printer supports color printing, use color.
if ( currentPageNumber == 1 )
{
e->PageSettings->Color = true;
}
}
}
private void myButtonPrint_OnClick(Object sender, System.EventArgs e)
{
// Set the printer name and ensure it is valid. If not,
// provide a message to the user.
printDoc.get_PrinterSettings().set_PrinterName("\\mynetworkprinter");
if (printDoc.get_PrinterSettings().get_IsValid()) {
// If the printer supports printing in color, then
// override the printer's default behavior.
if (printDoc.get_PrinterSettings().get_SupportsColor()) {
// Set the page default's to not print in color.
printDoc.get_DefaultPageSettings().set_Color(false);
}
// Provide a friendly name, set the page number, and print
// the document.
printDoc.set_DocumentName("My Presentation");
currentPageNumber = 1;
printDoc.Print();
}
else {
MessageBox.Show("Printer is not valid");
}
} //myButtonPrint_OnClick
private void MyPrintQueryPageSettingsEvent(Object sender,
QueryPageSettingsEventArgs e)
{
// Determines if the printer supports printing in color.
if (printDoc.get_PrinterSettings().get_SupportsColor()) {
// If the printer supports color printing, use color.
if (currentPageNumber == 1) {
e.get_PageSettings().set_Color(true);
}
}
} //MyPrintQueryPageSettingsEvent
平台
Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求。
版本信息
.NET Framework
受以下版本支持:2.0、1.1、1.0
请参见
参考
PageSettings 类
PageSettings 成员
System.Drawing.Printing 命名空间
PrinterSettings.SupportsColor