ExtendedProperty.Data 属性

项目
11/04/2008

获取或设置 ExtendedProperty 对象的数据。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public Property Data As Object
用法
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)

属性值

类型：System.Object
ExtendedProperty 对象的数据。

异常

异常	条件
ArgumentException	Data 未设置为以下类型之一： Char Char 数组 Byte Byte 数组 Int16 Int16 数组 UInt16 UInt16 数组 Int32 Int32 数组 UInt32 UInt32 数组 Int64 Int64 数组 UInt64 UInt64 数组 Single Single 数组 Double Double 数组 DateTime DateTime 数组 Boolean Boolean 数组 String Decimal Decimal 数组

Data 未设置为以下类型之一：

Char 数组

Byte 数组

Int16 数组

UInt16 数组

Int32 数组

UInt32 数组

Int64 数组

UInt64 数组

Single 数组

Double 数组

DateTime 数组

Boolean 数组

Decimal 数组

备注

数据包含无法使用其他方式在对象上设置的信息，如创建 Stroke 对象的时间或日期。

示例

此示例演示如何订阅 CursorDown 事件和 Stroke 事件来计算用户创建笔画所用的时间长度。

在笔画开始时，会激发 CursorDown 事件。当前时间会放置在 Stroke 对象的 ExtendedProperties 集合中。

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

笔画完成时，会激发 Stroke 事件。起始时间是从 Stroke 对象的 ExtendedProperties 集合中获取的，可用于计算所用的时间。

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