Cursor.DrawingAttributes (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene o establece los atributos de dibujo para aplicar a la entrada manuscrita mientras se dibuja.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Property DrawingAttributes As DrawingAttributes
'Uso
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)

Valor de propiedad

Tipo: Microsoft.Ink.DrawingAttributes
El objeto DrawingAttributes al que aplicarle la entrada manuscrita mientras se dibuja. Si este objeto es nullreferencia null (Nothing en Visual Basic) (Nothing en Microsoft Visual Basic .NET), el cursor utiliza los atributos de dibujo predeterminados del objeto recopilador de entrada manuscrita.

Comentarios

Los atributos de dibujo especifican la apariencia del trazo. Por ejemplo, puede especificar el ancho y el color de la entrada manuscrita.

Las llamadas sucesivas a la propiedad DrawingAttributes cambian sólo los atributos de dibujo de los trazos nuevos. Los trazos ya recopilados o en proceso de recopilación no se ven afectados.

Nota

La propiedad InkCollector.DefaultDrawingAttributes, InkOverlay.DefaultDrawingAttributes o InkPicture.DefaultDrawingAttributes contiene los atributos de dibujo que todos los cursores utilizan, a menos que establezcan su propia propiedad DrawingAttributes. Por ejemplo, tanto un objeto Cursor nuevo en el que no se haya establecido DrawingAttributes como un objeto Cursor anterior en el que DrawingAttributes se haya establecido en nullreferencia null (Nothing en Visual Basic) (Nothing en Visual Basic .NET) utilizan DefaultDrawingAttributes.

Un cursor puede tener atributos de dibujo diferentes para cada recopilador de entrada manuscrita (InkCollector, InkOverlay o InkPicture) con el que entre en contacto. Si no se especifican los atributos de dibujo de un cursor, éste utiliza los atributos de dibujo predeterminados del recopilador de entrada manuscrita. Estos atributos predeterminados se establecen con la propiedad DefaultDrawingAttributes de un recopilador de entrada manuscrita determinado (InkCollector.DefaultDrawingAttributes, InkOverlay.DefaultDrawingAttributes o [P:Microsoft.Ink.InkPicture. DefaultDrawingAttributes]).

Ejemplos

En este ejemplo, cuando el evento CursorInRange se desencadena, se realiza una comprobación para evaluar si se trata de la primera vez que el objeto InkCollector ha entrado en contacto con este objeto Cursor específico. En caso afirmativo, a la propiedad DrawingAttributes se le asigna un clon de la propiedad DefaultDrawingAttributes. De este modo, se garantiza que el acceso posterior a la propiedad DrawingAttributes no desencadene una excepción de referencia nula.

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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.