DrawingAttributes.ExtendedProperties-Eigenschaft

Artikel
10/28/2008

Ruft die Auflistung der von der Anwendung definierten Daten ab.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public ReadOnly Property ExtendedProperties As ExtendedProperties
'Usage
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

Eigenschaftenwert

Typ: Microsoft.Ink.ExtendedProperties
Die Auflistung der von der Anwendung definierten Daten.

Hinweise

Anwendungen können über die ExtendedProperties-Eigenschaft auf die benutzerdefinierten Daten zugreifen, die im DrawingAttributes-Objekt gespeichert werden. Diese benutzerdefinierten Daten werden automatisch mit dem Objekt serialisiert.

Beispiele

Dieses C#-Beispiel enthält eine freihandfähige Anwendung, die nur drei Arten von Freihandeingaben zulässt: mit einem dünnen schwarzen Stift, mit einem dicken blauen Stift oder einem gelben Textmarker. Ein Array aus DrawingAttributes-Objekten (availableDrawingAttributes) wird für diese drei Optionen erstellt, und jedes erhält zur Identifizierung eine GUID (drawingAttributesNameId). Die InitializeDrawingAttributes-Methode wird im Konstruktor aufgerufen, und die ChangeDrawingAttributes-Methode wird immer dann aufgerufen, wenn der Benutzer den Stift wechselt. Der Stiftname wird als eine ExtendedProperty des DrawingAttributes-Objekts gespeichert. Ein Label-Steuerelement (labelPenName) wird zur Anzeige des Stiftnamens verwendet.

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;
    }

Dieses Microsoft® Visual Basic® .NET-Beispiel enthält eine freihandfähige Anwendung, die nur drei Arten von Freihandeingaben zulässt: mit einem dünnen schwarzen Stift, mit einem dicken blauen Stift oder einem gelben Textmarker. Ein Array aus DrawingAttributes-Objekten (availableDrawingAttributes) wird für diese drei Optionen erstellt, und jedes erhält zur Identifizierung eine GUID (drawingAttributesNameId). Die InitializeDrawingAttributes-Methode wird im Konstruktor aufgerufen, und die ChangeDrawingAttributes-Methode wird immer dann aufgerufen, wenn der Benutzer den Stift wechselt. Der Stiftname wird als eine ExtendedProperty des DrawingAttributes-Objekts gespeichert. Ein Label-Steuerelement (labelPenName) wird zur Anzeige des Stiftnamens verwendet.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.