Printer.ColorMode-Eigenschaft

Artikel
10/24/2012

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Ausgabe farbig oder Monochrom auf einem Gerät druckt, das Farbdruck unterstützt.

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

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)

Eigenschaftswert

Typ: System.Int16
Gibt eine Short zurück.

Hinweise

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

Wenn Sie diese Eigenschaft festlegen, nachdem Sie die Print-Methode aufrufen, eine Laufzeitausnahme ausgelöst werden.

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

Konstante	Wert	Beschreibung
vbPRCMMonochrome	1	Monochrom (üblicherweise im Druckausgabe des Schattens Schwarzweißes).
vbPRCMColor	2	Druckausgabe in Farbe gedruckt.

Hinweis
Funktionen und Objekte im Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6-Namespace werden den Tools zur Aktualisierung von Visual Basic 6.0 auf Visual Basic bereitgestellt.In den meisten Fällen duplizieren diese Funktionen und Objekte Funktionen aus anderen Namespaces in .NET Framework.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 den Tools zur Aktualisierung von Visual Basic 6.0 auf Visual Basic bereitgestellt.In den meisten Fällen duplizieren diese Funktionen und Objekte Funktionen aus anderen Namespaces in .NET Framework.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 Farbdruck unterstützt und die ColorMode-Eigenschaft entsprechend festlegen.

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

.NET Framework-Sicherheit

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.