Printer.ColorMode (Propiedad)

Artículo
05/17/2015

Obtiene o establece un valor que especifica si la salida se imprimirá en color o en monocromático en un dispositivo que admite color.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
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)

Valor de propiedad

Tipo: Int16
Devuelve Short.

Comentarios

Cuando la propiedad de PrintAction se establece en PrintToPrinter y la impresora actual no admite color, se omite esta propiedad. Cuando la propiedad de PrintAction se establece en PrintToFile, los archivos se guardan en un formato de 8 bits de PostScript de escala de grises independientemente del valor de ColorMode .

Si establece esta propiedad después de llamar al método de Print , una excepción en tiempo de ejecución aparece.

La tabla siguiente se enumeran los valores de PrinterObjectConstants que son válidos para la propiedad de ColorMode .

Constante	Valor	Descripción
vbPRCMMonochrome	1	Salida de impresión en el monocromático (normalmente tonos de blanco y negro).
vbPRCMColor	2	Imprime generada en color.

Nota

Las funciones y los objetos del espacio de nombres Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 se proporcionan para que se utilicen con las herramientas de actualización de Visual Basic 6.0 a Visual Basic.En la mayoría de los casos, estos objetos y funciones proporcionan la misma funcionalidad que otros espacios de nombres de .NET Framework.Únicamente son necesarios cuando el modelo de código de Visual Basic 6.0 difiere notablemente de la implementación de .NET Framework.

Ejemplos

El ejemplo siguiente comprueba para ver si la impresora actual admite color y establezca la propiedad de ColorMode en consecuencia.

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.