StrokeCollection.GetPropertyData(Guid) Methode

Definition

Namespace:

System.Windows.Ink

Assembly:

PresentationCore.dll

Gibt den Wert der benutzerdefinierten Eigenschaft zurück, die der angegebenen Guid zugeordnet ist.

public:
 System::Object ^ GetPropertyData(Guid propertyDataId);

public object GetPropertyData (Guid propertyDataId);

member this.GetPropertyData : Guid -> obj

Public Function GetPropertyData (propertyDataId As Guid) As Object

Parameter

propertyDataId

Guid

Die Guid, die der abzurufenden benutzerdefinierten Eigenschaft zugeordnet ist.

Gibt zurück

Object

Der Wert der benutzerdefinierten Eigenschaft, die der angegebenen Guid zugeordnet ist.

Ausnahmen

ArgumentException

propertyDataId ist keiner benutzerdefinierten Eigenschaft der StrokeCollection zugeordnet.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Benutzerdefinierte Eigenschaftendaten hinzugefügt und abgerufen werden. Die AddTimeStamp_Click -Methode verwendet die AddPropertyData -Methode, um die aktuelle Uhrzeit der hinzuzufügen StrokeCollection. Die GetTimeStap_Click -Methode verwendet die GetPropertyData -Methode, um den Zeitstempel aus dem StrokeCollectionabzurufen. In diesem Beispiel wird davon ausgegangen, dass es einen InkCanvas namens inkCanvas1gibt.

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

Hinweise

Mit AddPropertyData den Methoden und GetPropertyData können Sie benutzerdefinierte Eigenschaften zu einer StrokeCollectionhinzufügen. Sie können dann zusätzliche Informationen mit einer StrokeCollectioneinschließen.