Freigeben über


ExtendedProperty.Data-Eigenschaft

Legt die Daten für das ExtendedProperty-Objekt fest oder ruft sie ab.

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

Syntax

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

Eigenschaftenwert

Typ: System.Object
Die Daten für das ExtendedProperty-Objekt.

Ausnahmen

Ausnahme Bedingung
ArgumentException

Data wird nicht auf einen der folgenden Typen festgelegt:

Char

Char-Array

Byte

Byte-Array

Int16

Int16-Array

UInt16

UInt16-Array

Int32

Int32-Array

UInt32

UInt32-Array

Int64

Int64-Array

UInt64

UInt64-Array

Single

Single-Array

Double

Double-Array

DateTime

DateTime-Array

Boolean

Boolean-Array

String

Decimal

Decimal-Array

Hinweise

Die Daten bestehen aus Informationen, die nicht auf andere Weise für das Objekt festgelegt werden können, beispielsweise die Uhrzeit oder das Datum der Erstellung eines Stroke-Objekts.

Beispiele

In diesem Beispiel wird veranschaulicht, wie Sie das CursorDown-Ereignis und das Stroke-Ereignis abonnieren können, um zu berechnen, wieviel Zeit der Benutzer zum Erstellen eines Strichs benötigt.

Am Anfang eines Strichs wird das CursorDown-Ereignis ausgelöst. Die aktuelle Zeit wird in der ExtendedProperties-Auflistung des Stroke-Objekts platziert.

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

Wenn der Strich abgeschlossen ist, wird das Stroke-Ereignis ausgelöst. Die Startzeit wird aus der ExtendedProperties-Auflistung des Stroke-Objekts abgerufen und zum Berechnen der verstrichenen Zeit verwendet.

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

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.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

ExtendedProperty-Klasse

ExtendedProperty-Member

Microsoft.Ink-Namespace

DrawingAttributes.ExtendedProperties

ExtendedProperties

Stroke.ExtendedProperties