StrokeCollection.AddPropertyData(Guid, Object) Metodo

Definizione

Spazio dei nomi:

System.Windows.Ink

Assembly:

PresentationCore.dll

Aggiunge una proprietà personalizzata a StrokeCollection.

public:
 void AddPropertyData(Guid propertyDataId, System::Object ^ propertyData);

public void AddPropertyData (Guid propertyDataId, object propertyData);

member this.AddPropertyData : Guid * obj -> unit

Public Sub AddPropertyData (propertyDataId As Guid, propertyData As Object)

Parametri

propertyDataId

Guid

Oggetto Guid da associare alla proprietà personalizzata.

propertyData

Object

Valore della proprietà personalizzata. propertyData deve essere di tipo Char, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Single, Double, DateTime, Boolean, String, Decimal o una matrice di questi tipi di dati, eccetto String, che non è consentito.

Eccezioni

ArgumentException

L'oggetto propertyDataId è un oggetto Guid vuoto.

-oppure-

L'oggetto propertyData non è uno dei tipi di dati consentiti, elencati nella sezione Parameters.

Esempio

Nell'esempio seguente viene illustrato come aggiungere e ottenere dati delle proprietà personalizzate. Il AddTimeStamp_Click metodo usa il AddPropertyData metodo per aggiungere l'ora corrente a StrokeCollection. Il GetTimeStap_Click metodo usa il GetPropertyData metodo per recuperare il timestamp da StrokeCollection. In questo esempio si presuppone che sia presente un InkCanvas denominato inkCanvas1.

Guid timestamp = new Guid("12345678-9012-3456-7890-123456789012");

// Add a timestamp to the StrokeCollection.
private void AddTimestamp_Click(object sender, RoutedEventArgs e)
{

    inkCanvas1.Strokes.AddPropertyData(timestamp, DateTime.Now);
}

// Get the timestamp of the StrokeCollection.
private void GetTimestamp_Click(object sender, RoutedEventArgs e)
{

    if (inkCanvas1.Strokes.ContainsPropertyData(timestamp))
    {
        object date = inkCanvas1.Strokes.GetPropertyData(timestamp);

        if (date is DateTime)
        {
            MessageBox.Show("This StrokeCollection's timestamp is " +
                ((DateTime)date).ToString());
        }
    }
    else
    {
        MessageBox.Show(
            "The StrokeCollection does not have a timestamp.");
    }
}

Private timestamp As New Guid("12345678-9012-3456-7890-123456789012")

' Add a timestamp to the StrokeCollection.
Private Sub AddTimestamp_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)

    inkCanvas1.Strokes.AddPropertyData(timestamp, DateTime.Now)

End Sub

' Get the timestamp of the StrokeCollection.
Private Sub GetTimestamp_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)

    If inkCanvas1.Strokes.ContainsPropertyData(timestamp) Then

        Dim savedDate As Object = inkCanvas1.Strokes.GetPropertyData(timestamp)

        If TypeOf savedDate Is DateTime Then
            MessageBox.Show("This StrokeCollection's timestamp is " & _
                CType(savedDate, DateTime).ToString())
        End If
    Else
        MessageBox.Show("The StrokeCollection does not have a timestamp.")
    End If

End Sub

Commenti

Il AddPropertyData metodo consente di aggiungere proprietà personalizzate a un oggetto StrokeCollection. È quindi possibile includere informazioni aggiuntive con .StrokeCollection