Printer.ColorMode-Eigenschaft

Artikel
05/16/2015

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Ausgabe farbig oder monochrom auf einem Gerät gedruckt wird, das einen 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: Int16
Gibt eine Short zurück.

Hinweise

Wenn die Eigenschaft PrintAction auf PrintToPrinter festgelegt ist und der aktuelle Farbe Drucker nicht unterstützt, wird diese Eigenschaft ignoriert. Wenn die Eigenschaft PrintAction auf PrintToFile festgelegt wird, werden die Dateien in einem äußerst Graustufenen-PostScript-Format unabhängig vom ColorMode-Wert gespeichert.

Wenn Sie diese Eigenschaft festlegen, nachdem Sie die Print-Methode aufrufen, wird eine Laufzeitausnahme auftreten.

Die folgende Tabelle zeigt die PrinterObjectConstants-Werten, die für ColorMode die Eigenschaft gültig sind.

Konstante	Wert	Beschreibung
vbPRCMMonochrome	1	Druckausgabe im Monochrom (normalerweise Schatten des Schwarzweißes).
vbPRCMColor	2	Druckausgabe in der Farbe.

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.

Beispiele

Im folgenden Beispiel wird überprüft, um festzustellen, ob die aktuelle Druckerunterstützung Einfärben und legt die ColorMode-Eigenschaft entsprechend fest.

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.