DrawingAttributes.ExtendedProperties 屬性

發行項
10/29/2008

取得應用程式定義資料的集合。

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public ReadOnly Property ExtendedProperties As ExtendedProperties
'用途
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

屬性值

型別：Microsoft.Ink.ExtendedProperties
應用程式定義資料的集合。

備註

應用程式可以使用 ExtendedProperties 屬性，存取儲存在 DrawingAttributes 物件中的自訂資料。這項自訂資料會自動隨物件序列化。

範例

這個 C# 範例包含一個「已啟用筆墨」的應用程式，這個應用程式只允許下列三種筆墨：細黑色畫筆、粗藍色麥克筆和黃色螢光筆。這個範例會針對這三個選項建立 DrawingAttributes 物件的陣列 availableDrawingAttributes，而且會指定每個物件的識別 GUID (drawingAttributesNameId)。接著，會在建構函式中呼叫 InitializeDrawingAttributes 方法，而且每次使用者變更畫筆時都會呼叫 ChangeDrawingAttributes 方法。畫筆名稱會儲存為 DrawingAttributes 物件的 ExtendedProperty。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;
    }

這個 Microsoft® Visual Basic® .NET 範例包含一個「已啟用筆墨」的應用程式，這個應用程式只允許下列三種筆墨：細黑色畫筆、粗藍色麥克筆和黃色螢光筆。這個範例會針對這三個選項建立 DrawingAttributes 物件的陣列 availableDrawingAttributes，而且會指定每個物件的識別 GUID (drawingAttributesNameId)。接著，會在建構函式中呼叫 InitializeDrawingAttributes 方法，而且每次使用者變更畫筆時都會呼叫 ChangeDrawingAttributes 方法。畫筆名稱會儲存為 DrawingAttributes 物件的 ExtendedProperty。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