Cursor.DrawingAttributes, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit les attributs de dessin à appliquer à l'entrée manuscrite pendant le tracé.

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

Syntaxe

'Déclaration
Public Property DrawingAttributes As DrawingAttributes
'Utilisation
Dim instance As Cursor
Dim value As DrawingAttributes

value = instance.DrawingAttributes

instance.DrawingAttributes = value

public DrawingAttributes DrawingAttributes { get; set; }

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

/** @property */
public DrawingAttributes get_DrawingAttributes()
/** @property */
public  void set_DrawingAttributes(DrawingAttributes value)

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

Valeur de propriété

Type : Microsoft.Ink.DrawingAttributes
Objet DrawingAttributes à appliquer à l'entrée manuscrite à mesure qu'elle est tracée. Si cet objet a la valeur nullune référence null (Nothing en Visual Basic) (Nothing en Microsoft Visual Basic .NET), le curseur utilise les attributs de dessin par défaut de l'objet collecteur d'entrée manuscrite.

Notes

Les attributs de dessin spécifient l'apparence du trait. Par exemple, vous pouvez spécifier l'épaisseur et la couleur de l'entrée manuscrite.

Des appels consécutifs à la propriété DrawingAttributes modifient uniquement les attributs de dessin des nouveaux traits. Ils ne s'appliquent pas aux traits qui sont déjà collectés ou en train de l'être.

Remarque :
La propriété InkCollector.DefaultDrawingAttributes, InkOverlay.DefaultDrawingAttributes ou InkPicture.DefaultDrawingAttributes contient les attributs de dessin que tous les curseurs utilisent à moins qu'ils aient défini leur propre propriété DrawingAttributes. Par exemple, un nouvel objet Cursor sur lequel DrawingAttributes n'est pas défini et un objet Cursor ancien sur lequel DrawingAttributes a la valeur nullune référence null (Nothing en Visual Basic) (Nothing en Visual Basic .NET) utilisent tout deux la propriété DefaultDrawingAttributes.

La propriété InkCollector.DefaultDrawingAttributes, InkOverlay.DefaultDrawingAttributes ou InkPicture.DefaultDrawingAttributes contient les attributs de dessin que tous les curseurs utilisent à moins qu'ils aient défini leur propre propriété DrawingAttributes. Par exemple, un nouvel objet Cursor sur lequel DrawingAttributes n'est pas défini et un objet Cursor ancien sur lequel DrawingAttributes a la valeur nullune référence null (Nothing en Visual Basic) (Nothing en Visual Basic .NET) utilisent tout deux la propriété DefaultDrawingAttributes.

Un curseur peut avoir des attributs de dessin différents pour chaque collecteur d'entrée manuscrite (InkCollector, InkOverlay ou InkPicture) avec lequel il entre en contact. Si vous ne spécifiez aucun attribut de dessin pour un curseur, il utilise les attributs par défaut du collecteur d'entrée manuscrite. Ces attributs par défaut sont définis avec la propriété DefaultDrawingAttributes d'un collecteur d'entrée manuscrite spécifique (InkCollector.DefaultDrawingAttributes, InkOverlay.DefaultDrawingAttributes ou [P:Microsoft.Ink.InkPicture. DefaultDrawingAttributes]).

Exemples

Dans cet exemple, lorsque l'événement CursorInRange se déclenche, un contrôle vérifie si c'est la première fois que l'objet InkCollector entre en contact avec cet objet Cursor spécifique. Si c'est le cas, un clone de la propriété DefaultDrawingAttributes est assigné à la propriété DrawingAttributes. Ainsi, lors de l'accès suivant à la propriété, DrawingAttributes aucune exception de référence null n'est levée.

Private Sub mInkObject_CursorInRange(ByVal sender As Object, ByVal e As InkCollectorCursorInRangeEventArgs)
    Const MOUSE_CURSOR_ID As Integer = 1
    If e.NewCursor Then
        ' mInkObject can be InkCollector, InkOverlay, or InkPicture
        e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone()
        ' if this cursor is the mouse, we'll set color to red
        If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
            e.Cursor.DrawingAttributes.Color = Color.Red
        End If

    End If
End Sub

private void mInkObject_CursorInRange(object sender, InkCollectorCursorInRangeEventArgs e)
{
    const int MOUSE_CURSOR_ID = 1;

    if (e.NewCursor)
    {
        // mInkObject can be InkCollector, InkOverlay, or InkPicture
        e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone();
        // if this cursor is the mouse, we'll set color to red
        if (MOUSE_CURSOR_ID == e.Cursor.Id)
        {
            e.Cursor.DrawingAttributes.Color = Color.Red;
        }
    }
}

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.