Proprietà ExtendedProperty.Data

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta i dati dell'oggetto ExtendedProperty.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Property Data As Object
'Utilizzo
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)

Valore proprietà

Tipo: System.Object
Dati dell'oggetto ExtendedProperty.

Eccezioni

Eccezione	Condizione
ArgumentException	Data non è impostato su uno dei seguenti tipi: Char Matrice Char Byte Matrice Byte Int16 Matrice Int16 UInt16 Matrice UInt16 Int32 Matrice Int32 UInt32 Matrice UInt32 Int64 Matrice Int64 UInt64 Matrice UInt64 Single Matrice Single Double Matrice Double DateTime Matrice DateTime Boolean Matrice Boolean String Decimal Matrice Decimal

ArgumentException

Data non è impostato su uno dei seguenti tipi:

Matrice Char

Matrice Byte

Matrice Int16

Matrice UInt16

Matrice Int32

Matrice UInt32

Matrice Int64

Matrice UInt64

Matrice Single

Matrice Double

Matrice DateTime

Matrice Boolean

Matrice Decimal

Note

I dati sono costituiti da informazioni che non possono essere impostate altrimenti sull'oggetto, ad esempio l'ora o la data in cui un oggetto Stroke è stato creato.

Esempi

In questo esempio viene illustrato come sottoscrivere l'evento CursorDown e l'evento Stroke per calcolare il tempo richiesto per la creazione di un tratto da parte dell'utente.

All'inizio di un tratto, viene generato l'evento CursorDown. L'ora corrente viene posizionata nell'insieme ExtendedProperties dell'oggetto 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);
}

Al termine del tratto, viene generato l'evento Stroke. L'ora di inizio viene recuperata dall'insieme ExtendedProperties dell'oggetto Stroke e utilizzata per calcolare il tempo trascorso.

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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.