Printer.ColorMode プロパティ

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

カラー印刷が可能なデバイスで出力をカラーとモノクロのどちらで印刷するかを指定する値を、取得または設定します。

名前空間 : Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
アセンブリ : Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)

構文

'宣言
Public Property ColorMode As Short
'使用
Dim instance As Printer
Dim value As Short

value = instance.ColorMode

instance.ColorMode = value

public short ColorMode { get; set; }

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

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

プロパティ値

型 : System.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 2008 へのアップグレードツールで使用するために用意されています。ほとんどの場合、これらの関数とオブジェクトは、.NET Framework の他の名前空間にある機能と重複しています。これらが必要になるのは、Visual Basic 6.0 のコードモデルが .NET Framework の実装と大きく異なる場合だけです。

Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 名前空間の関数とオブジェクトは、Visual Basic 6.0 から Visual Basic 2008 へのアップグレードツールで使用するために用意されています。ほとんどの場合、これらの関数とオブジェクトは、.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