Cursor.DrawingAttributes 屬性

發行項
10/29/2008

取得或設定繪製「筆墨」時所套用的繪圖屬性 (Attribute)。

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

語法

'宣告
Public Property DrawingAttributes As DrawingAttributes
'用途
Dim instance As Cursor
Dim value As DrawingAttributes

value = instance.DrawingAttributes

instance.DrawingAttributes = value

public DrawingAttributes DrawingAttributes { get; set; }

public:
property DrawingAttributes^ DrawingAttributes {
    DrawingAttributes^ get ();
    void set (DrawingAttributes^ value);
}

/** @property */
public DrawingAttributes get_DrawingAttributes()
/** @property */
public  void set_DrawingAttributes(DrawingAttributes value)

public function get DrawingAttributes () : DrawingAttributes
public function set DrawingAttributes (value : DrawingAttributes)

屬性值

型別：Microsoft.Ink.DrawingAttributes
繪製筆墨時套用的 DrawingAttributes 物件。如果這個物件是 nullNull 參照 (即 Visual Basic 中的 Nothing) (在 Microsoft Visual Basic .NET 中為 Nothing)，則游標會使用筆墨收集器物件預設的繪圖屬性 (Attribute)。

備註

繪圖屬性 (Attribute) 可用來指定「筆劃」的外觀。例如，您可以指定筆墨的寬度和色彩。

後續呼叫 DrawingAttributes 屬性 (Property) 只會變更新筆劃的繪圖屬性 (Attribute)。這些屬性不會套用至已收集或正在收集的筆劃。

注意事項：
除非所有游標都設定了專屬的 DrawingAttributes 屬性 (Property)，否則 InkCollector.DefaultDrawingAttributes、InkOverlay.DefaultDrawingAttributes 或 InkPicture.DefaultDrawingAttributes 會包含這些游標使用的繪圖屬性 (Attribute)。例如，未設定 DrawingAttributes 的新 Cursor 物件和 DrawingAttributes 設為 nullNull 參照 (即 Visual Basic 中的 Nothing) (在 Visual Basic .NET 中為 Nothing) 的舊 Cursor 物件都會使用 DefaultDrawingAttributes。

除非所有游標都設定了專屬的 DrawingAttributes 屬性 (Property)，否則 InkCollector.DefaultDrawingAttributes、InkOverlay.DefaultDrawingAttributes 或 InkPicture.DefaultDrawingAttributes 會包含這些游標使用的繪圖屬性 (Attribute)。例如，未設定 DrawingAttributes 的新 Cursor 物件和 DrawingAttributes 設為 nullNull 參照 (即 Visual Basic 中的 Nothing) (在 Visual Basic .NET 中為 Nothing) 的舊 Cursor 物件都會使用 DefaultDrawingAttributes。

每個「筆墨收集器」(InkCollector、InkOverlay 或 InkPicture) 所接觸的游標都可以有不同的繪圖屬性 (Attribute)。如果未指定游標的繪圖屬性 (Attribute)，則游標會使用筆墨收集器預設的繪圖屬性 (Attribute)。這些預設屬性 (Attribute) 是與特定筆墨收集器 (InkCollector.DefaultDrawingAttributes、InkOverlay.DefaultDrawingAttributes 或 [P:Microsoft.Ink.InkPicture. DefaultDrawingAttributes]) 的 DefaultDrawingAttributes 屬性 (Property) 一併設定。

範例

在這個範例中，當 CursorInRange 事件引發時，會檢查 InkCollector 物件是否第一次接觸這個特定 Cursor 物件。如果是，則會將 DefaultDrawingAttributes 屬性的複製品 (Clone) 指派給 DrawingAttributes 屬性。這樣可確定後續對 DrawingAttributes 屬性的存取不會擲回 null 參考例外狀況。

Private Sub mInkObject_CursorInRange(ByVal sender As Object, ByVal e As InkCollectorCursorInRangeEventArgs)
    Const MOUSE_CURSOR_ID As Integer = 1
    If e.NewCursor Then
        ' mInkObject can be InkCollector, InkOverlay, or InkPicture
        e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone()
        ' if this cursor is the mouse, we'll set color to red
        If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
            e.Cursor.DrawingAttributes.Color = Color.Red
        End If

    End If
End Sub

private void mInkObject_CursorInRange(object sender, InkCollectorCursorInRangeEventArgs e)
{
    const int MOUSE_CURSOR_ID = 1;

    if (e.NewCursor)
    {
        // mInkObject can be InkCollector, InkOverlay, or InkPicture
        e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone();
        // if this cursor is the mouse, we'll set color to red
        if (MOUSE_CURSOR_ID == e.Cursor.Id)
        {
            e.Cursor.DrawingAttributes.Color = Color.Red;
        }
    }
}