Proprietà DrawingAttributes.Color

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta il colore dell'input penna disegnato con l'oggetto DrawingAttributes.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Property Color As Color
'Utilizzo
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)

Valore proprietà

Tipo: System.Drawing.Color
Colore dell'input penna disegnato con l'oggetto DrawingAttributes.

Valore	Significato
Black	Il rendering dell'input penna viene eseguito in nero con l'impostazione Black.
System.Drawing.Color	Il rendering dell'input penna viene eseguito nel colore dell'oggetto Color selezionato.

Note

In modalità Contrasto elevato, l'input penna appare sempre con l'impostazione del colore di sistema (WindowText), indipendentemente dall'impostazione della proprietà Color. Tuttavia, il colore effettivo dell'input penna viene sempre salvato come il colore impostato nella proprietà Color (o come il colore predefinito se non impostato). Ad esempio, se la proprietà Color è impostata su (Red) un utente in modalità Contrasto elevato visualizza l'input penna nel colore di sistema, mentre un utente non in modalità Contrasto elevato visualizza l'input penna disegnato come il colore impostato (Red). Questa funzionalità consente a un utente in modalità Contrasto elevato di visualizzare l'input penna nell'impostazione di sistema senza modificare il colore effettivo del tratto.

Ciò significa che per impostazione predefinita, in modalità Contrasto elevato tutti gli input penna vengono mappati su un colore. Per disabilitare questo comportamento di mapping dei colori predefinito e implementarne uno personalizzato, utilizzare la proprietà SupportHighContrastInk (InkCollector.SupportHighContrastInk, InkOverlay.SupportHighContrastInk o InkPicture.SupportHighContrastInk) dell'agente di raccolta dell'input penna.

Per abilitare la modalità Contrasto elevato, è necessario impostare la proprietà AutoRedraw (InkCollector.AutoRedraw, InkOverlay.AutoRedraw o InkPicture.AutoRedraw) dell'agente di raccolta dell'input penna su true. Se si imposta la proprietà AutoRedraw su true, l'input penna viene ridisegnato quando la finestra viene invalidata. L'API Tablet PC non supporta la modalità Contrasto elevato se la proprietà AutoRedraw è impostata su false.

Esempi

In questo esempio C# sono contenuti i gestori di menu che modificano la proprietà Color di un oggetto 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();
    }

In questo esempio Microsoft® Visual Basic® .NET sono contenuti i gestori di menu che modificano la proprietà Color di un oggetto 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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.