StrokeCollection.AddPropertyData(Guid, Object) Метод

Определение

Пространство имен:

System.Windows.Ink

Сборка:

PresentationCore.dll

Добавляет настраиваемое свойство в коллекцию 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)

Параметры

propertyDataId

Guid

Guid для связывания с пользовательским свойством.

propertyData

Object

Значение пользовательского свойства. Параметр propertyData должен относиться к типу Char, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Single, Double, DateTime, Boolean, String, Decimal или быть массивом этих типов данных, кроме типа String, который не допускается.

Исключения

ArgumentException

propertyDataId является пустым Guid.

-или-

Параметр propertyData не относится ни к одному из разрешенных типов данных, перечисленных в разделе Parameters.

Примеры

В следующем примере показано, как добавить и получить данные пользовательских свойств. Метод AddTimeStamp_Click использует метод для AddPropertyData добавления текущего времени в StrokeCollection. Метод GetTimeStap_Click использует метод для GetPropertyData получения метки времени из StrokeCollection. В этом примере предполагается, что существует объект с InkCanvas именем 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

Комментарии

Метод AddPropertyData позволяет добавлять пользовательские свойства в StrokeCollection. Затем можно добавить дополнительные сведения с помощью StrokeCollection.