Proprietà DrawingAttributes.ExtendedProperties

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene l'insieme di dati definiti dall'applicazione.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public ReadOnly Property ExtendedProperties As ExtendedProperties
'Utilizzo
Dim instance As DrawingAttributes
Dim value As ExtendedProperties

value = instance.ExtendedProperties

public ExtendedProperties ExtendedProperties { get; }

public:
property ExtendedProperties^ ExtendedProperties {
    ExtendedProperties^ get ();
}

/** @property */
public ExtendedProperties get_ExtendedProperties()

public function get ExtendedProperties () : ExtendedProperties

Valore proprietà

Tipo: Microsoft.Ink.ExtendedProperties
Insieme di dati definiti dall'applicazione.

Note

Le applicazioni possono utilizzare la proprietà ExtendedProperties per accedere ai dati personalizzati archiviati nell'oggetto DrawingAttributes. Questi dati personalizzati vengono automaticamente serializzati con l'oggetto.

Esempi

In questo esempio C# è contenuta un'applicazione abilitata per l'input penna che consente solo tre tipi di input penna: una penna nera sottile, un evidenziatore blu spesso e un evidenziatore giallo. Una matrice di oggetti DrawingAttributes, availableDrawingAttributes, viene creata per queste tre opzioni a ciascuna delle quali viene assegnato un GUID identificativo, drawingAttributesNameId. Il metodo InitializeDrawingAttributes viene chiamato nel costruttore e il metodo ChangeDrawingAttributes viene chiamato ogni volta che l'utente cambia penna. Il nome della penna è archiviato come ExtendedProperty dell'oggetto DrawingAttributes. Per visualizzare il nome della penna viene utilizzato un oggetto Label, labelPenName.

using Microsoft.Ink;
//...
    private InkOverlay theInkOverlay;
    private DrawingAttributes[] availableDrawingAttributes;
    private Guid drawingAttributesNameId;
    private System.Windows.Forms.Label labelPenName; 
//...
    private void InitializeDrawingAttributes()
    {
        availableDrawingAttributes = new DrawingAttributes[3];
        drawingAttributesNameId = Guid.NewGuid();

        // Thin pen
        availableDrawingAttributes[0] = new DrawingAttributes(new Pen(Color.Black, 1));
        availableDrawingAttributes[0].ExtendedProperties.Add(drawingAttributesNameId, "Thin pen");

        // Thick marker
        availableDrawingAttributes[1] = new DrawingAttributes(new Pen(Color.Blue, 200));
        availableDrawingAttributes[1].ExtendedProperties.Add(drawingAttributesNameId, "Thick marker");

        // Highlighter
        availableDrawingAttributes[2] = new DrawingAttributes(Color.Yellow);
        availableDrawingAttributes[2].Height = 800;
        availableDrawingAttributes[2].Width = 1;
        availableDrawingAttributes[2].PenTip = PenTip.Rectangle;
        availableDrawingAttributes[2].Transparency = 125;
        availableDrawingAttributes[2].ExtendedProperties.Add(drawingAttributesNameId, "Highlighter");
    }

    private void ChangeDrawingAttributes(int index)
    {
        // Set the default drawing attributes of the InkOverlay
        theInkOverlay.DefaultDrawingAttributes = availableDrawingAttributes[index];

        // Display the pen name that you are using
        labelPenName.Text = 
            (String)availableDrawingAttributes[index].ExtendedProperties[drawingAttributesNameId].Data;
    }

In questo esempio Microsoft® Visual Basic® .NET è contenuta un'applicazione abilitata per l'input penna che consente solo tre tipi di input penna: una penna nera sottile, un evidenziatore blu spesso e un evidenziatore giallo. Una matrice di oggetti DrawingAttributes, availableDrawingAttributes, viene creata per queste tre opzioni a ciascuna delle quali viene assegnato un GUID identificativo, drawingAttributesNameId. Il metodo InitializeDrawingAttributes viene chiamato nel costruttore e il metodo ChangeDrawingAttributes viene chiamato ogni volta che l'utente cambia penna. Il nome della penna è archiviato come ExtendedProperty dell'oggetto DrawingAttributes. Per visualizzare il nome della penna viene utilizzato un oggetto Label, labelPenName.

Imports Microsoft.Ink
'...
Private WithEvents theInkOverlay As InkOverlay
Private availableDrawingAttributes As DrawingAttributes()
Private drawingAttributesNameId As Guid
Friend WithEvents LabelPenName As System.Windows.Forms.Label
'...
Private Sub InitializeDrawingAttributes()
    ReDim availableDrawingAttributes(2)
    drawingAttributesNameId = Guid.NewGuid()

    'Thin pen
    availableDrawingAttributes(0) = New DrawingAttributes(New Pen(Color.Black, 1))
    availableDrawingAttributes(0).ExtendedProperties.Add(drawingAttributesNameId, "Thin pen")

    'Thick marker
    availableDrawingAttributes(1) = New DrawingAttributes(New Pen(Color.Blue, 200))
    availableDrawingAttributes(1).ExtendedProperties.Add(drawingAttributesNameId, "Thick marker")

    'Highlighter
    availableDrawingAttributes(2) = New DrawingAttributes(Color.Yellow)
    availableDrawingAttributes(2).Height = 800
    availableDrawingAttributes(2).Width = 1
    availableDrawingAttributes(2).PenTip = PenTip.Rectangle
    availableDrawingAttributes(2).Transparency = 125
    availableDrawingAttributes(2).ExtendedProperties.Add(drawingAttributesNameId, "Highlighter")
End Sub

Private Sub ChangeDrawingAttributes(ByVal index As Integer)
    'Set the default drawing attributes of the InkOverlay
    theInkOverlay.DefaultDrawingAttributes = availableDrawingAttributes(index)

    'Display the pen name that you are using
    LabelPenName.Text = _
        availableDrawingAttributes(index).ExtendedProperties(drawingAttributesNameId).Data
End Sub

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.