StrokeCollection.AddPropertyData(Guid, Object) Methode

Referenz

Definition

Namespace:: System.Windows.Ink

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt der StrokeCollection eine benutzerdefinierte Eigenschaft hinzu.

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)

Parameter

propertyDataId: Guid

Die der benutzerdefinierten Eigenschaft zuzuordnende Guid.

propertyData: Object

Der Wert der benutzerdefinierten Eigenschaft. propertyData muss vom Typ Char, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Single, Double, DateTime, Boolean, String, Decimal oder ein Array dieser Datentypen sein, mit Ausnahme von String, der nicht zulässig ist.

Ausnahmen

ArgumentException

propertyDataId ist eine leere Guid.

- oder -

propertyData ist keiner der im Abschnitt Parameters aufgelisteten zulässigen Datentypen.

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 der -Methode können Sie benutzerdefinierte Eigenschaften zu einer StrokeCollectionhinzufügen. Sie können dann zusätzliche Informationen mit einer StrokeCollectioneinschließen.

Gilt für: