Langue

StrokeCollection.AddPropertyData(Guid, Object) Méthode

Définition

Espace de noms:
System.Windows.Ink
Assembly:
PresentationCore.dll

Ajoute une propriété personnalisée à l’objet 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)

Paramètres

propertyDataId
Guid

À Guid associer à la propriété personnalisée.

propertyData
Object

Valeur de la propriété personnalisée. propertyDatadoit être de type Char, ByteInt16UInt16Int32UInt32Int64UInt64SingleDoubleDateTime, Boolean, , ou StringDecimal un tableau de ces types de données, sauf String, qui n’est pas autorisé.

Exceptions

ArgumentException

propertyDataId est vide Guid.

- ou -

propertyData n’est pas l’un des types de données autorisés répertoriés dans la Parameters section.

Exemples

L’exemple suivant montre comment ajouter et obtenir des données de propriété personnalisées. La AddTimeStamp_Click méthode utilise la AddPropertyData méthode pour ajouter l’heure actuelle au StrokeCollection. La GetTimeStap_Click méthode utilise la GetPropertyData méthode pour récupérer l’horodatage à partir du StrokeCollection. Cet exemple suppose qu’il existe un InkCanvas appelé 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

Remarques

La AddPropertyData méthode vous permet d’ajouter des propriétés personnalisées à un StrokeCollection. Vous pouvez ensuite inclure des informations supplémentaires avec un StrokeCollection.

S’applique à