DrawingAttributes.ExtendedProperties, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient la collection des données définies par l'application.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public ReadOnly Property ExtendedProperties As ExtendedProperties
'Utilisation
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

Valeur de propriété

Type : Microsoft.Ink.ExtendedProperties
Collection de données définies par l'application.

Notes

Les applications peuvent utiliser la propriété ExtendedProperties pour accéder aux données personnalisées stockées dans l'objet DrawingAttributes. Ces données personnalisées sont automatiquement sérialisées avec l'objet.

Exemples

Cet exemple C# contient une application prenant en charge les entrées manuscrites qui autorise uniquement trois types d'entrée manuscrite : le crayon noir fin, le marqueur bleu épais et le surligneur jaune. Un tableau d'objets DrawingAttributes, availableDrawingAttributes, est créé pour ces trois options, chacune disposant d'un GUID d'identification, drawingAttributesNameId. La méthode InitializeDrawingAttributes est appelée dans le constructeur, puis la méthode ChangeDrawingAttributes est appelée à chaque fois que l'utilisateur change de stylet. Le nom du stylet est stocké comme ExtendedProperty de l'objet DrawingAttributes. Un LabellabelPenName (page pouvant être en anglais), est utilisé pour afficher le nom du stylet.

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

Cet exemple Microsoft® Visual Basic® .NET contient une application prenant en charge les entrées manuscrites qui autorise uniquement trois types d'entrée manuscrite : le crayon noir fin, le marqueur bleu épais et le surligneur jaune. Un tableau d'objets DrawingAttributes, availableDrawingAttributes, est créé pour ces trois options, chacune disposant d'un GUID d'identification, drawingAttributesNameId. La méthode InitializeDrawingAttributes est appelée dans le constructeur, puis la méthode ChangeDrawingAttributes est appelée à chaque fois que l'utilisateur change de stylet. Le nom du stylet est stocké comme ExtendedProperty de l'objet DrawingAttributes. Un LabellabelPenName (page pouvant être en anglais), est utilisé pour afficher le nom du stylet.

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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.