StrokeCollection.AddPropertyData(Guid, Object) Methode

Definition

Namespace:
System.Windows.Ink
Assembly:
PresentationCore.dll

Fügt der StrokeCollectionEigenschaft 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

Der Guid der benutzerdefinierten Eigenschaft zugeordnete Wert.

propertyData
Object

Der Wert der benutzerdefinierten Eigenschaft. propertyDatamuss vom Typ Char, , , ByteInt16, UInt16, , Int32, UInt32, Int64UInt64, Single, DoubleDateTime, Booleanoder String ein Array dieser Datentypen sein, mit AusnahmeDecimal, das nicht zulässig Stringist.

Ausnahmen

ArgumentException

propertyDataId ist ein leerer Guid.

-oder-

propertyData ist keiner der zulässigen Datentypen, die Parameters im Abschnitt aufgeführt sind.

Beispiele

Das folgende Beispiel veranschaulicht, wie benutzerdefinierte Eigenschaftendaten hinzugefügt und abgerufen werden. Die AddTimeStamp_Click Methode verwendet die AddPropertyData Methode, um der aktuellen Uhrzeit hinzuzufügen StrokeCollection. Die GetTimeStap_Click Methode verwendet die GetPropertyData Methode, um den Zeitstempel aus dem StrokeCollection. In diesem Beispiel wird davon ausgegangen, dass ein aufgerufener InkCanvas Vorgang vorhanden inkCanvas1ist.

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 der AddPropertyData Methode können Sie benutzerdefinierte Eigenschaften zu einem StrokeCollection. Anschließend können Sie zusätzliche Informationen mit einer StrokeCollection.

Gilt für: