Procedura: Aggiungere dati personalizzati ai dati di inchiostro

È possibile aggiungere dati personalizzati all'inchiostro che verranno salvati quando l'inchiostro viene salvato in formato serializzato come ISF. È possibile salvare i dati personalizzati nel DrawingAttributes, nell'StrokeCollectiono nell'Stroke. La possibilità di salvare dati personalizzati su tre oggetti consente di decidere la posizione migliore per salvare i dati. Tutte e tre le classi usano metodi simili per archiviare e accedere ai dati personalizzati.

Solo i tipi seguenti possono essere salvati come dati personalizzati:

• Boolean

• Boolean[]

• Byte

• Byte[]

• Char

• Char[]

• DateTime

• DateTime[]

• Decimal

• Decimal[]

• Double

• Double[]

• Int16

• Int16[]

• Int32

• Int32[]

• Int64

• Int64[]

• Single

• Single[]

• String

• UInt16

• UInt16[]

• UInt32

• UInt32[]

• UInt64

• UInt64[]

Esempio

Nell'esempio seguente viene illustrato come aggiungere e recuperare dati personalizzati da un StrokeCollection.

Guid timestamp = new Guid("12345678-9012-3456-7890-123456789012");

// Add a timestamp to the StrokeCollection.
private void AddTimestamp()
{

    inkCanvas1.Strokes.AddPropertyData(timestamp, DateTime.Now);
}

// Get the timestamp of the StrokeCollection.
private void GetTimestamp()
{

    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.");
    }
}

Nell'esempio seguente viene creata un'applicazione che visualizza un InkCanvas e due pulsanti. Il pulsante, switchAuthor, consente di usare due penne da parte di due autori diversi. Il pulsante changePenColors modifica il colore di ogni tratto sul InkCanvas in base all'autore. L'applicazione definisce due oggetti DrawingAttributes e aggiunge una proprietà personalizzata a ognuna che indica quale autore ha disegnato il Stroke. Quando l'utente fa clic su changePenColors, l'applicazione modifica l'aspetto del tratto in base al valore della proprietà personalizzata.

<Window x:Class="Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    Title="Adding Custom Data to Ink" Height="500" Width="700"
    >
  <DockPanel Name="root">

    <StackPanel  Background="DarkSlateBlue">
      <Button Name="switchAuthor" Click="switchAuthor_click" >
        Switch to student's pen 
      </Button>
      <Button Name="changePenColors" Click="changeColor_click" >
        Change the color of the pen ink
      </Button>
    </StackPanel>
    <InkCanvas Name="inkCanvas1">
    </InkCanvas>
  </DockPanel>
</Window>

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Shapes;
using System.Windows.Ink;

/// <summary>
/// Interaction logic for Window1.xaml
/// </summary>

public partial class Window1 : Window
{
    Guid authorGuid = new Guid("12345678-9012-3456-7890-123456789012");
    DrawingAttributes teachersDA = new DrawingAttributes();
    DrawingAttributes studentsDA = new DrawingAttributes();
    string teacher = "teacher";
    string student = "student";
    bool useStudentPen = false;

    public Window1()
    {
        InitializeComponent();

        teachersDA.Color = Colors.Red;
        teachersDA.Width = 5;
        teachersDA.Height = 5;
        teachersDA.AddPropertyData(authorGuid, teacher);

        studentsDA.Color = Colors.Blue;
        studentsDA.Width = 5;
        studentsDA.Height = 5;
        studentsDA.AddPropertyData(authorGuid, student);

        inkCanvas1.DefaultDrawingAttributes = teachersDA;
    }

    // Switch between using the 'pen' DrawingAttributes and the
    // 'highlighter' DrawingAttributes.
    void switchAuthor_click(Object sender, RoutedEventArgs e)
    {
        useStudentPen = !useStudentPen;

        if (useStudentPen)
        {
            switchAuthor.Content = "Use teacher's pen";
            inkCanvas1.DefaultDrawingAttributes = studentsDA;
        }
        else
        {
            switchAuthor.Content = "Use student's pen";
            inkCanvas1.DefaultDrawingAttributes = teachersDA;
        }
    }

    // Change the color of the ink that on the InkCanvas that used the pen.
    void changeColor_click(Object sender, RoutedEventArgs e)
    {
        foreach (Stroke s in inkCanvas1.Strokes)
        {
            if (s.DrawingAttributes.ContainsPropertyData(authorGuid))
            {
                object data = s.DrawingAttributes.GetPropertyData(authorGuid);

                if ((data is string) && ((string)data == teacher))
                {
                    s.DrawingAttributes.Color = Colors.Black;
                }
                if ((data is string) && ((string)data == student))
                {
                    s.DrawingAttributes.Color = Colors.Green;
                }
            }
        }
    }
}