DrawingAttributes.Color, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit la couleur de l'entrée manuscrite tracée avec cet objet DrawingAttributes.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Property Color As Color
'Utilisation
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)

Valeur de propriété

Type : System.Drawing.Color
Couleur de l'entrée manuscrite tracée avec cet objet DrawingAttributes.

Valeur	Signification
Black (page pouvant être en anglais)	L'entrée manuscrite est restituée en Black (page pouvant être en anglais).
System.Drawing.Color	L'entrée manuscrite est restituée dans la couleur de l'objet Color (page pouvant être en anglais) sélectionné.

Notes

Dans l'affichage à contraste élevé, l'entrée manuscrite apparaît toujours avec le paramètre de couleur système (WindowText) (page pouvant être en anglais), indépendamment du paramètre de la propriété Color. Toutefois, la couleur réelle de l'entrée manuscrite est toujours enregistrée en tant que couleur définie dans la propriété Color (ou couleur par défaut, si ce n'est pas le cas). Par exemple, si la propriété Color a la valeur (Red) (page pouvant être en anglais), un utilisateur en affichage à contraste élevé voit l'entrée manuscrite dans la couleur système, mais un utilisateur qui n'est pas en affichage à contraste élevé voit l'entrée manuscrite de la couleur définie comme Red. Cette fonctionnalité permet à un utilisateur en affichage à contraste élevé de voir l'entrée manuscrite selon le paramètre système sans modification de la couleur de trait réelle.

Cela signifie que, par défaut, toute entrée manuscrite est mappée à une couleur en affichage à contraste élevé. Pour désactiver ce comportement de mappage de couleur par défaut et implémenter vos choix, utilisez la propriété SupportHighContrastInk du collecteur d'entrée manuscrite (InkCollector.SupportHighContrastInk, InkOverlay.SupportHighContrastInk ou InkPicture.SupportHighContrastInk).

Pour activer l'affichage à contraste élevé, vous devez affecter la valeur true à la propriété AutoRedraw (InkCollector.AutoRedraw, InkOverlay.AutoRedraw ou InkPicture.AutoRedraw) du collecteur d'entrée manuscrite. Si vous affectez la valeur true à la propriété AutoRedraw, l'entrée manuscrite est retracée lorsque la fenêtre n'est pas valide. L'interface de programmation d'applications (API) Tablet PC ne prend pas en charge l'affichage à contraste élevé si vous affectez la valeur false à la propriété AutoRedraw.

Exemples

Cet exemple C# contient des gestionnaires de menu qui modifient la propriété Color d'un objet 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();
    }

Cet exemple Microsoft® Visual Basic® .NET contient des gestionnaires de menu qui modifient la propriété Color d'un objet 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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.