Cursor.DrawingAttributes-Eigenschaft

Artikel
11/26/2008

Ruft die Zeichnungsattribute ab, die während des Zeichnens auf Freihand angewendet werden sollen, oder legt diese fest.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Property DrawingAttributes As DrawingAttributes
'Usage
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)

Eigenschaftenwert

Typ: Microsoft.Ink.DrawingAttributes
Das DrawingAttributes-Objekt, das während des Zeichnens auf Freihand angewendet werden soll. Wenn dieses Objekt nullNULL-Verweis (Nothing in Visual Basic) entspricht (Nothing in Microsoft Visual Basic .NET), verwendet der Cursor die Standardzeichnungsattribute des Freihanderfassungsmodul-Objekts.

Hinweise

Die Zeichnungsattribute geben die Gestalt des Strichs an. Zum Beispiel können Sie die Breite und die Farbe der Freihandeingaben angeben.

Durch nachfolgende Aufrufe der DrawingAttributes-Eigenschaft werden lediglich die Zeichenattribute neuer Striche geändert. Sie gelten nicht für Striche, die bereits erfasst wurden oder gerade erfasst werden.

Hinweis

InkCollector.DefaultDrawingAttributes, InkOverlay.DefaultDrawingAttributes oder InkPicture.DefaultDrawingAttributes enthalten die Zeichnungsattribute, die von allen Cursorn verwendet werden, sofern sie nicht ihre eigene DrawingAttributes-Eigenschaft festlegen. Beispielsweise verwenden ein neues Cursor-Objekt, für das DrawingAttributes nicht festgelegt ist, und ein altes Cursor-Objekt, für das DrawingAttributes auf nullNULL-Verweis (Nothing in Visual Basic) (Nothing in Visual Basic .NET) festgelegt ist, beide DefaultDrawingAttributes.

Ein Cursor kann über unterschiedliche Zeichnungsattribute für jedes Freihanderfassungsmodul (InkCollector, InkOverlay oder InkPicture) verfügen, mit dem es in Kontakt kommt. Wenn Sie keine Zeichnungsattribute für einen Cursor angeben, verwendet er die Standardzeichnungsattribute des Freihanderfassungsmoduls. Diese Standardattribute werden mit der DefaultDrawingAttributes-Eigenschaft des betreffenden Freihanderfassungsmoduls (InkCollector.DefaultDrawingAttributes, InkOverlay.DefaultDrawingAttributes oder [P:Microsoft.Ink.InkPicture. DefaultDrawingAttributes]) festgelegt.

Beispiele

In diesem Beispiel wird überprüft, ob das InkCollector-Objekt zum ersten Mal Kontakt mit diesem Cursor-Objekt hat, wenn das CursorInRange-Ereignis ausgelöst wird. Wenn dies der Fall ist, wird die DrawingAttributes-Eigenschaft einem Klon der DefaultDrawingAttributes-Eigenschaft zugewiesen. Hierdurch wird verhindert, dass durch den anschließenden Zugriff auf die DrawingAttributes-Eigenschaft eine NULL-Verweisausnahme ausgelöst wird.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.