StrokeCollection.AddPropertyData(Guid, Object) Método

Definición

Espacio de nombres:

System.Windows.Ink

Ensamblado:

PresentationCore.dll

Agrega una propiedad personalizada a 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)

Parámetros

propertyDataId

Guid

Guid que se va a asociar a la propiedad personalizada.

propertyData

Object

Valor de la propiedad personalizada. propertyData debe ser de tipo Char, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Single, Double, DateTime, Boolean, String, Decimal o una matriz de estos tipos de datos, excepto String, que no se permite.

Excepciones

ArgumentException

propertyDataId es un Guid vacío.

O bien propertyData no es ninguno de los tipos de datos permitidos que se muestran en la sección Parameters.

Ejemplos

En el ejemplo siguiente se muestra cómo agregar y obtener datos de propiedad personalizados. El AddTimeStamp_Click método usa el AddPropertyData método para agregar la hora actual a StrokeCollection. El GetTimeStap_Click método usa el GetPropertyData método para recuperar la marca de tiempo de .StrokeCollection En este ejemplo se supone que hay un InkCanvas elemento denominado 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

Comentarios

El AddPropertyData método permite agregar propiedades personalizadas a .StrokeCollection A continuación, puede incluir información adicional con .StrokeCollection