Proprietà Cursor.DrawingAttributes

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta gli attributi di disegno da applicare all'input penna quando viene disegnato.

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

Sintassi

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

Valore proprietà

Tipo: Microsoft.Ink.DrawingAttributes
Oggetto DrawingAttributes da applicare all'input penna quando viene disegnato. Se questo oggetto è nullriferimento null (Nothing in Visual Basic) (Nothing in Microsoft Visual Basic .NET), il cursore utilizza gli attributi di disegno predefiniti dell'oggetto agente di raccolta dell'input penna.

Note

Gli attributi di disegno specificano l'aspetto del tratto. È ad esempio possibile specificare lo spessore e il colore dell'input penna.

Chiamate successive alla proprietà DrawingAttributes modificano solo gli attributi di disegno dei tratti nuovi. Non sono applicabili ai tratti la cui raccolta è in corso o è già stata completata.

Nota

InkCollector.DefaultDrawingAttributes, InkOverlay.DefaultDrawingAttributes o InkPicture.DefaultDrawingAttributes contengono gli attributi di disegno utilizzati da tutti i cursori, a meno che tali cursori non impostino la rispettiva proprietà DrawingAttributes. Ad esempio, sia un nuovo oggetto Cursor per cui non è impostato l'oggetto DrawingAttributes, sia un oggetto Cursor obsoleto per cui l'oggetto DrawingAttributes è impostato su nullriferimento null (Nothing in Visual Basic) (Nothing in Visual Basic .NET) utilizzano la proprietà DefaultDrawingAttributes.

Un cursore può disporre di attributi di disegno diversi per ogni agente di raccolta dell'input penna (InkCollector, InkOverlay o InkPicture) con cui entra in contatto. Se non si specificano gli attributi di disegno per un cursore, vengono utilizzati gli attributi di disegno predefiniti dell'agente di raccolta dell'input penna. Questi attributi predefiniti sono impostati con la proprietà DefaultDrawingAttributes dell'agente di raccolta dell'input penna specifico (InkCollector.DefaultDrawingAttributes, InkOverlay.DefaultDrawingAttributes o [P:Microsoft.Ink.InkPicture. DefaultDrawingAttributes]).

Esempi

In questo esempio, quando viene generato l'evento CursorInRange, viene effettuato un controllo per verificare se è la prima volta che l'oggetto InkCollector entra in contatto con questo particolare oggetto Cursor. In questo caso, la proprietà DrawingAttributes viene assegnata a un clone della proprietà DefaultDrawingAttributes. In questo modo viene garantito che l'accesso successivo alla proprietà DrawingAttributes non generi un'eccezione di riferimento null.

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;
        }
    }
}

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.