StrokeCollection.AddPropertyData(Guid, Object) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Ink

Assembly:: PresentationCore.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Aggiunge una proprietà personalizzata 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)

Parametri

propertyDataId: Guid

Oggetto Guid da associare alla proprietà personalizzata.

propertyData: Object

Valore della proprietà personalizzata. propertyData deve essere di tipo Char, Byte, Int16, UInt16, Int32, UInt32, Int64, UInt64, Single, Double, DateTime, Boolean, String, Decimal o una matrice di questi tipi di dati, eccetto String, che non è consentito.

Eccezioni

ArgumentException

L'oggetto propertyDataId è un oggetto Guid vuoto.

-oppure-

L'oggetto propertyData non è uno dei tipi di dati consentiti, elencati nella sezione Parameters.

Esempio

Nell'esempio seguente viene illustrato come aggiungere e ottenere dati delle proprietà personalizzate. Il AddTimeStamp_Click metodo usa il AddPropertyData metodo per aggiungere l'ora corrente a StrokeCollection. Il GetTimeStap_Click metodo usa il GetPropertyData metodo per recuperare il timestamp da StrokeCollection. In questo esempio si presuppone che sia presente un InkCanvas denominato 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

Commenti

Il AddPropertyData metodo consente di aggiungere proprietà personalizzate a un oggetto StrokeCollection. È quindi possibile includere informazioni aggiuntive con .StrokeCollection

Si applica a

Condividi tramite