DrawingAttributes.ExtendedProperties (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene la colección de datos definidos por la aplicación.

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

Sintaxis

'Declaración
Public ReadOnly Property ExtendedProperties As ExtendedProperties
'Uso
Dim instance As DrawingAttributes
Dim value As ExtendedProperties

value = instance.ExtendedProperties

public ExtendedProperties ExtendedProperties { get; }

public:
property ExtendedProperties^ ExtendedProperties {
    ExtendedProperties^ get ();
}

/** @property */
public ExtendedProperties get_ExtendedProperties()

public function get ExtendedProperties () : ExtendedProperties

Valor de propiedad

Tipo: Microsoft.Ink.ExtendedProperties
Colección de datos definidos por la aplicación.

Comentarios

Las aplicaciones pueden utilizar la propiedad ExtendedProperties para tener acceso a los datos personalizados que se almacenan en el objeto DrawingAttributes. Estos datos personalizados se serializan automáticamente con el objeto.

Ejemplos

En este ejemplo de C#, se incluye una aplicación habilitada para entrada manuscrita que admite sólo tres tipos de entrada manuscrita: pluma negra fina, marcador azul grueso y marcador de resaltado amarillo. Se crea una matriz de objetos DrawingAttributes, availableDrawingAttributes, para estas tres opciones, a cada una de las cuales se le proporciona un GUID de identificación, drawingAttributesNameId. Se llama al método InitializeDrawingAttributes en el constructor y se llama al método ChangeDrawingAttributes siempre que el usuario cambia de pluma. El nombre de la pluma se almacena como ExtendedProperty del objeto DrawingAttributes. Se usa Label, labelPenName para mostrar el nombre de la pluma.

using Microsoft.Ink;
//...
    private InkOverlay theInkOverlay;
    private DrawingAttributes[] availableDrawingAttributes;
    private Guid drawingAttributesNameId;
    private System.Windows.Forms.Label labelPenName; 
//...
    private void InitializeDrawingAttributes()
    {
        availableDrawingAttributes = new DrawingAttributes[3];
        drawingAttributesNameId = Guid.NewGuid();

        // Thin pen
        availableDrawingAttributes[0] = new DrawingAttributes(new Pen(Color.Black, 1));
        availableDrawingAttributes[0].ExtendedProperties.Add(drawingAttributesNameId, "Thin pen");

        // Thick marker
        availableDrawingAttributes[1] = new DrawingAttributes(new Pen(Color.Blue, 200));
        availableDrawingAttributes[1].ExtendedProperties.Add(drawingAttributesNameId, "Thick marker");

        // Highlighter
        availableDrawingAttributes[2] = new DrawingAttributes(Color.Yellow);
        availableDrawingAttributes[2].Height = 800;
        availableDrawingAttributes[2].Width = 1;
        availableDrawingAttributes[2].PenTip = PenTip.Rectangle;
        availableDrawingAttributes[2].Transparency = 125;
        availableDrawingAttributes[2].ExtendedProperties.Add(drawingAttributesNameId, "Highlighter");
    }

    private void ChangeDrawingAttributes(int index)
    {
        // Set the default drawing attributes of the InkOverlay
        theInkOverlay.DefaultDrawingAttributes = availableDrawingAttributes[index];

        // Display the pen name that you are using
        labelPenName.Text = 
            (String)availableDrawingAttributes[index].ExtendedProperties[drawingAttributesNameId].Data;
    }

En este ejemplo de Microsoft® Visual Basic® .NET, se incluye una aplicación habilitada para entrada manuscrita que admite sólo tres tipos de entrada manuscrita: pluma negra fina, marcador azul grueso y marcador de resaltado amarillo. Se crea una matriz de objetos DrawingAttributes, availableDrawingAttributes, para estas tres opciones, a cada una de las cuales se le proporciona un GUID de identificación, drawingAttributesNameId. Se llama al método InitializeDrawingAttributes en el constructor y se llama al método ChangeDrawingAttributes siempre que el usuario cambia de pluma. El nombre de la pluma se almacena como ExtendedProperty del objeto DrawingAttributes. Se usa Label, labelPenName para mostrar el nombre de la pluma.

Imports Microsoft.Ink
'...
Private WithEvents theInkOverlay As InkOverlay
Private availableDrawingAttributes As DrawingAttributes()
Private drawingAttributesNameId As Guid
Friend WithEvents LabelPenName As System.Windows.Forms.Label
'...
Private Sub InitializeDrawingAttributes()
    ReDim availableDrawingAttributes(2)
    drawingAttributesNameId = Guid.NewGuid()

    'Thin pen
    availableDrawingAttributes(0) = New DrawingAttributes(New Pen(Color.Black, 1))
    availableDrawingAttributes(0).ExtendedProperties.Add(drawingAttributesNameId, "Thin pen")

    'Thick marker
    availableDrawingAttributes(1) = New DrawingAttributes(New Pen(Color.Blue, 200))
    availableDrawingAttributes(1).ExtendedProperties.Add(drawingAttributesNameId, "Thick marker")

    'Highlighter
    availableDrawingAttributes(2) = New DrawingAttributes(Color.Yellow)
    availableDrawingAttributes(2).Height = 800
    availableDrawingAttributes(2).Width = 1
    availableDrawingAttributes(2).PenTip = PenTip.Rectangle
    availableDrawingAttributes(2).Transparency = 125
    availableDrawingAttributes(2).ExtendedProperties.Add(drawingAttributesNameId, "Highlighter")
End Sub

Private Sub ChangeDrawingAttributes(ByVal index As Integer)
    'Set the default drawing attributes of the InkOverlay
    theInkOverlay.DefaultDrawingAttributes = availableDrawingAttributes(index)

    'Display the pen name that you are using
    LabelPenName.Text = _
        availableDrawingAttributes(index).ExtendedProperties(drawingAttributesNameId).Data
End Sub

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.