Printer.ColorMode-Eigenschaft

Článek
08/23/2008

Aktualisiert: November 2007

Ruft einen Wert ab bzw. legt einen Wert fest, der bestimmt, ob die Ausgabe auf einem Gerät, das die Ausgabe in Farbe unterstützt, in Farbe oder monochrom gedruckt wird.

Namespace: Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
Public Property ColorMode As Short
'Usage
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)

Eigenschaftenwert

Typ: System.Int16

Gibt Short zurück.

Hinweise

Wenn die PrintAction-Eigenschaft auf PrintToPrinter festgelegt ist und der aktuelle Drucker den Farbdruck nicht unterstützt, wird diese Eigenschaft ignoriert. Wenn die PrintAction-Eigenschaft auf PrintToFile festgelegt ist, werden die Dateien in einem 8-Bit-Graustufen-PostScript-Format gespeichert, unabhängig vom ColorMode-Wert.

Wenn diese Eigenschaft nach dem Aufrufen der Print-Methode festgelegt wird, tritt eine Laufzeitausnahme auf.

In der folgenden Tabelle werden die PrinterObjectConstants-Werte aufgelistet, die für die ColorMode-Eigenschaft gültig sind.

Konstante	Wert	Beschreibung
vbPRCMMonochrome	1	Die Ausgabe wird monochrom (normalerweise schwarzweiß) gedruckt.
vbPRCMColor	2	Die Ausgabe wird in Farbe gedruckt.

Hinweis:
Funktionen und Objekte im Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6-Namespace werden für die Tools zur Aktualisierung von Visual Basic 6.0 auf Visual Basic 2008 bereitgestellt. In den meisten Fällen duplizieren diese Funktionen und Objekte Funktionalitäten, die Sie in anderen Namespaces in .NET Framework finden können. Sie sind nur notwendig, wenn sich das Visual Basic 6.0-Codemodell erheblich von der .NET Framework-Implementierung unterscheidet.

Funktionen und Objekte im Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6-Namespace werden für die Tools zur Aktualisierung von Visual Basic 6.0 auf Visual Basic 2008 bereitgestellt. In den meisten Fällen duplizieren diese Funktionen und Objekte Funktionalitäten, die Sie in anderen Namespaces in .NET Framework finden können. Sie sind nur notwendig, wenn sich das Visual Basic 6.0-Codemodell erheblich von der .NET Framework-Implementierung unterscheidet.

Beispiele

Im folgenden Beispiel wird überprüft, ob der aktuelle Drucker den Farbdruck unterstützt. Außerdem wird die ColorMode-Eigenschaft entsprechend festgelegt.

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

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.