ExtendedProperty.Data (Propiedad)

Artículo
10/28/2008

Actualización: noviembre 2007

Obtiene o establece los datos del objeto ExtendedProperty.

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

Sintaxis

'Declaración
Public Property Data As Object
'Uso
Dim instance As ExtendedProperty
Dim value As Object

value = instance.Data

instance.Data = value

public Object Data { get; set; }

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

/** @property */
public Object get_Data()
/** @property */
public  void set_Data(Object value)

public function get Data () : Object
public function set Data (value : Object)

Valor de propiedad

Tipo: System.Object
Datos del objeto ExtendedProperty.

Excepciones

Excepción	Condición
ArgumentException	Data no se establece en uno de los tipos siguientes: Char Matriz de Char Byte Matriz de Byte Int16 Matriz de Int16 UInt16 Matriz de UInt16 Int32 Matriz de Int32 UInt32 Matriz de UInt32 Int64 Matriz de Int64 UInt64 Matriz de UInt64 Single Matriz de Single Double Matriz de Double DateTime Matriz de DateTime Boolean Matriz de Boolean String Decimal Matriz de Decimal

ArgumentException

Data no se establece en uno de los tipos siguientes:

Matriz de Char

Matriz de Byte

Matriz de Int16

Matriz de UInt16

Matriz de Int32

Matriz de UInt32

Matriz de Int64

Matriz de UInt64

Matriz de Single

Matriz de Double

Matriz de DateTime

Matriz de Boolean

Matriz de Decimal

Comentarios

Los datos están compuestos de información que no se puede establecer de otro modo en el objeto, por ejemplo, la hora o la fecha en que se creó un objeto Stroke.

Ejemplos

En este ejemplo se muestra cómo puede suscribirse al evento CursorDown y al evento Stroke para calcular el período de tiempo que tarda el usuario en crear un trazo.

Al comienzo de un trazo, se desencadena el evento CursorDown. La hora actual se sitúa en la colección ExtendedProperties del objeto Stroke.

Private Sub mInkObject_CursorDown(ByVal sender As Object, ByVal e As InkCollectorCursorDownEventArgs)
    ' add extended property indicating the time the stroke started
    ' STROKE_START_GUID is class level string via GUID generator
    e.Stroke.ExtendedProperties.Add(New Guid(STROKE_START_GUID), DateTime.Now)
End Sub

private void mInkObject_CursorDown(object sender, InkCollectorCursorDownEventArgs e)
{
    // add extended property indicating the time the stroke started
    // STROKE_START_GUID is class level string via GUID generator
    e.Stroke.ExtendedProperties.Add(new Guid(STROKE_START_GUID), DateTime.Now);
}

Cuando se completa el trazo, se desencadena el evento Stroke. La hora de inicio se recupera de la colección ExtendedProperties del objeto Stroke y se usa para calcular el tiempo transcurrido.

Private Sub mInkObject_Stroke1(ByVal sender As Object, ByVal e As InkCollectorStrokeEventArgs)
    ' check to see if extended property for start time exists
    ' Attempting to access an extended property that hasn't been created throws an exception
    ' STROKE_START_GUID is class level string via GUID generator
    If (e.Stroke.ExtendedProperties.DoesPropertyExist(New Guid(STROKE_START_GUID))) Then

        Dim startTime As DateTime = DirectCast(e.Stroke.ExtendedProperties(New Guid(STROKE_START_GUID)).Data, DateTime)
        Dim endTime As DateTime = DateTime.Now
        Dim span As TimeSpan = New TimeSpan(endTime.Ticks - startTime.Ticks)

        ' add extended property indicating the time the stroke ended
        ' STROKE_END_GUID is class level string via GUID generator
        e.Stroke.ExtendedProperties.Add(New Guid(STROKE_END_GUID), endTime)

        ' display the number of seconds in creating this stroke
        Me.statusLabelStrokeTime.Text = span.TotalSeconds.ToString()
    End If
End Sub

private void mInkObject_Stroke1(object sender, InkCollectorStrokeEventArgs e)
{
    // check to see if extended property for start time exists
    // Attempting to access an extended property that hasn't been created throws an exception
    // STROKE_START_GUID is class level string via GUID generator
    if (e.Stroke.ExtendedProperties.DoesPropertyExist(new Guid(STROKE_START_GUID)))
    {
        DateTime startTime = (DateTime)e.Stroke.ExtendedProperties[new Guid(STROKE_START_GUID)].Data;
        DateTime endTime = DateTime.Now;
        TimeSpan span = new TimeSpan(endTime.Ticks - startTime.Ticks);

        // add extended property indicating the time the stroke ended
        // STROKE_END_GUID is class level string via GUID generator
        e.Stroke.ExtendedProperties.Add(new Guid(STROKE_END_GUID), endTime);

        // display the number of seconds in creating this stroke
        this.statusLabelStrokeTime.Text = span.TotalSeconds.ToString();
    }
}

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.