DrawingAttributes.Color (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene o establece el color de la entrada manuscrita que se dibuja con este objeto DrawingAttributes.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Property Color As Color
'Uso
Dim instance As DrawingAttributes
Dim value As Color

value = instance.Color

instance.Color = value

public Color Color { get; set; }

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

/** @property */
public Color get_Color()
/** @property */
public  void set_Color(Color value)

public function get Color () : Color
public function set Color (value : Color)

Valor de propiedad

Tipo: System.Drawing.Color
Color de la entrada manuscrita que se dibuja con este objeto DrawingAttributes.

Valor	Significado
Black	La entrada manuscrita se representa en Black.
System.Drawing.Color	La entrada manuscrita se representa en el color del objeto Color seleccionado.

Comentarios

En modo de alto contraste, la entrada manuscrita siempre se muestra con el valor de color del sistema (WindowText), sin tener en cuenta el valor de la propiedad Color. Sin embargo, el color real de la entrada manuscrita siempre se guarda como el color establecido en la propiedad Color (o el color predeterminado, si no se establece). Por ejemplo, si la propiedad Color se establece en Red, un usuario en modo de alto contraste verá la entrada manuscrita con el color del sistema, pero un usuario que no esté en modo de alto contraste verá la entrada manuscrita dibujada con el color establecido (Red). Esta funcionalidad permite a un usuario en modo de alto contraste ver la entrada manuscrita con la configuración del sistema sin modificar el color del trazo real.

Esto significa que, de forma predeterminada, toda la entrada manuscrita se asigna a un mismo color en modo de alto contraste. Para deshabilitar este comportamiento de asignación de color predeterminado e implementar el suyo propio, use la propiedad SupportHighContrastInk (InkCollector.SupportHighContrastInk, InkOverlay.SupportHighContrastInk o InkPicture.SupportHighContrastInk) del recopilador de entrada manuscrita.

Para habilitar eficazmente el modo de alto contraste, debe establecer en true la propiedad AutoRedraw (InkCollector.AutoRedraw, InkOverlay.AutoRedraw o InkPicture.AutoRedraw) del recopilador de entrada manuscrita. Si establece la propiedad AutoRedraw en true, la entrada manuscrita se vuelve a dibujar cuando se invalida la ventana. La interfaz de programación de aplicaciones (API) de Tablet PC no admite el modo de alto contraste si se establece la propiedad AutoRedraw en false.

Ejemplos

En este ejemplo de C#, se incluyen controladores de menú que cambian la propiedad Color de un objeto DrawingAttributes.

using Microsoft.Ink;
using System.Drawing;
//...
    private System.Windows.Forms.MenuItem menuInkColorRed;
    private System.Windows.Forms.MenuItem menuInkColorBlue;
    private InkCollector theInkCollector;
    private System.Windows.Forms.MenuItem checkedColor;

//...
    private void menuInkColorRed_Click(
    object sender, System.EventArgs e)
    {
        checkedColor.Checked = false;
        theInkCollector.DefaultDrawingAttributes.Color = Color.Red;
        checkedColor = menuInkColorRed;
        checkedColor.Checked = true;
        Refresh();
    }

    private void menuInkColorBlue_Click(
    object sender, System.EventArgs e)
    {
        checkedColor.Checked = false;
        theInkCollector.DefaultDrawingAttributes.Color = Color.Blue;
        checkedColor = menuInkColorBlue;
        checkedColor.Checked = true;
        Refresh();
    }

En este ejemplo de Microsoft® Visual Basic® .NET, se incluyen controladores de menú que cambian la propiedad Color de un objeto DrawingAttributes.

Imports Microsoft.Ink
Imports System.Drawing
'...
    Dim MenuInkColorRed As System.Windows.Forms.MenuItem
    Dim MenuInkColorBlue As System.Windows.Forms.MenuItem
    Dim CheckedColor As System.Windows.Forms.MenuItem
    Dim theInkCollector As InkCollector
'...
    Private Sub MenuInkColorRed_Click( _
    ByVal sender As Object, ByVal e As System.EventArgs)
        CheckedColor.Checked = False
        theInkCollector.DefaultDrawingAttributes.Color = Color.Red
        CheckedColor = MenuInkColorRed
        CheckedColor.Checked = True
        Refresh()
    End Sub

    Private Sub MenuInkColorBlue_Click( _
    ByVal sender As Object, ByVal e As System.EventArgs)
        CheckedColor.Checked = False
        theInkCollector.DefaultDrawingAttributes.Color = Color.Blue
        CheckedColor = MenuInkColorBlue
        CheckedColor.Checked = True
        Refresh()
    End Sub

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.