Printer.ColorMode 屬性

發行項
05/16/2015

取得或設定值，指定在支援彩色的裝置上，將會以彩色或單色列印輸出。

命名空間： Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
組件： Microsoft.VisualBasic.PowerPacks.Vs (在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中)

語法

'宣告
Public Property ColorMode As Short

public short ColorMode { get; set; }

public:
property short ColorMode {
    short get ();
    void set (short value);
}

member ColorMode : int16 with get, set

function get ColorMode () : short 
function set ColorMode (value : short)

屬性值

類型：Int16
傳回 Short。

備註

當 PrintAction 屬性設定為 PrintToPrinter ，且目前的印表機不支援彩色列印，這個屬性會被忽略。當 PrintAction 屬性設定為 PrintToFile時，不論 ColorMode 的值，檔案會以 8 位元的灰階 PostScript 格式儲存。

如果您將這個屬性，在呼叫 Print 方法後，會產生執行階段例外狀況。

下表列出 ColorMode 的屬性是有效的 PrinterObjectConstants 值。

常數	值	說明
vbPRCMMonochrome	1	在單色列印的輸出 (通常是灰階黑白)。
vbPRCMColor	2	以彩色列印輸出。

注意事項
Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 命名空間中的函式和物件都是供這些工具使用，以便從 Visual Basic 6.0 升級至 Visual Basic。在大多數情況下，這些函式和物件會複製在 .NET Framework 的其他命名空間中可以找到的功能。只有當 Visual Basic 6.0 程式碼模型與 .NET Framework 實作有顯著差異時，才需要這些項目。

Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 命名空間中的函式和物件都是供這些工具使用，以便從 Visual Basic 6.0 升級至 Visual Basic。在大多數情況下，這些函式和物件會複製在 .NET Framework 的其他命名空間中可以找到的功能。只有當 Visual Basic 6.0 程式碼模型與 .NET Framework 實作有顯著差異時，才需要這些項目。

範例

下列範例會檢查目前印表機是否支援彩色並適當地設定 ColorMode 屬性。

Dim pr As New Printer
Dim ps As New Printing.PrinterSettings
If ps.SupportsColor = True Then
    pr.ColorMode = vbPRCMColor
Else
    pr.ColorMode = vbPRCMMonochrome
End If