StrokeCollection.AddPropertyData(Guid, Object) Método

Definição

Namespace:

System.Windows.Ink

Assembly:

PresentationCore.dll

Adiciona uma propriedade personalizada ao 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

O Guid a ser associado à propriedade personalizada.

propertyData

Object

O valor da propriedade personalizada. propertyData deve ser do tipo Char, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Single, Double, DateTime, Boolean, String, Decimal ou uma matriz desses tipos de dados, exceto String, que não é permitido.

Exceções

ArgumentException

propertyDataId é um Guid vazio.

- ou - propertyData não é um dos tipos de dados permitidos listados na seção Parameters.

Exemplos

O exemplo a seguir demonstra como adicionar e obter dados de propriedade personalizados. O AddTimeStamp_Click método usa o AddPropertyData método para adicionar a hora atual ao StrokeCollection. O GetTimeStap_Click método usa o GetPropertyData método para recuperar o carimbo de data/hora do StrokeCollection. Este exemplo pressupõe que há um InkCanvas chamado 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

Comentários

O AddPropertyData método permite adicionar propriedades personalizadas a um StrokeCollection. Em seguida, você pode incluir informações extras com um StrokeCollection.