InkCollector.Cursors 屬性

發行項
10/29/2008

取得可用於筆墨區域的 Cursors 集合。

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

語法

'宣告
Public ReadOnly Property Cursors As Cursors
'用途
Dim instance As InkCollector
Dim value As Cursors

value = instance.Cursors

public Cursors Cursors { get; }

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

/** @property */
public Cursors get_Cursors()

public function get Cursors () : Cursors

屬性值

型別：Microsoft.Ink.Cursors
可用於筆墨區域的 Cursors 集合。

備註

每個游標對應於畫筆或其他筆墨輸入裝置的筆尖。

在這個集合中的游標都是 InkCollector 物件的區域游標。

InkCollector 物件所遇到的任何新游標都會加入至傳回的 Cursors 集合，然而不一定會按照 InkCollector 物件遇到這些游標的順序傳回它們。

當您在 InkCollector 物件上啟用滑鼠做為輸入裝置時 (即 SetAllTabletsMode 方法的 useMouseForInput 參數為 true 時)，滑鼠會在 InkCollector 遇到任何其他游標 (如畫筆) 之後被加入至 Cursors 集合。這是因為畫筆也可以做為滑鼠使用。

注意事項：
在任何其他游標之後的滑鼠游標會收到 CursorInRange 事件，例如，當畫筆繪製筆劃 (會引發 Stroke 事件) 時。

在下列情況下，會清除 Cursors 集合 (計數設定為 0，不包含任何物件)：

手寫板模式已變更 (例如，從 SetSingleTabletIntegratedMode 變更為 SetAllTabletsMode)。
呼叫 SetSingleTabletIntegratedMode 方法。

範例

這個 C# 範例會傳回一份報告，內容是關於做為參數傳入的 InkCollector 物件所遇到的所有游標屬性。

using Microsoft.Ink;
//. . .
public string CursorReport(InkCollector theInkCollector)
{
    string theReport = "The InkCollector has encountered the following cursors so far:" + Environment.NewLine;
    // Get the Cursors collection from the InkCollector
    Microsoft.Ink.Cursors theCursors = theInkCollector.Cursors;
    // Prevent changes to the collection while we iterate over it.
    lock( theCursors.SyncRoot )
    {
        theReport += "Count of cursors: " + theCursors.Count + Environment.NewLine + Environment.NewLine ;
        foreach (Microsoft.Ink.Cursor cursor in theCursors)
        {
            theReport += "Cursor Name: " + cursor.Name + Environment.NewLine;
            theReport += "Cursor ToString: " + cursor.ToString() + Environment.NewLine;
            theReport += "Tablet Name: " + cursor.Tablet.Name  + Environment.NewLine;
            theReport += "Cursor Id: " + cursor.Id.ToString()  + Environment.NewLine;
            theReport += "Cursor is inverted: " + cursor.Inverted.ToString()  + Environment.NewLine;
            theReport += "Cursor Buttons:" + Environment.NewLine;
            foreach (CursorButton button in cursor.Buttons)
            {
                CursorButtonState theState = button.State;
                theReport += "    Button Name: " + button.Name + Environment.NewLine;
                theReport += "    State: " + button.State.ToString() + Environment.NewLine;
                theReport += "    Id: " + button.Id.ToString()  + Environment.NewLine + Environment.NewLine;
            }
        }
    }
    return theReport;
}

這個 Microsoft Visual Basic .NET 範例會傳回一份報告，內容是關於做為參數傳入的 InkCollector 物件所遇到的所有游標屬性。

Imports Microsoft.Ink
'. . .
Public Function CursorReport(ByVal theInkCollector As InkCollector) _
    As String
    Dim theReport As String = "The InkCollector has encountered " & _
        "the following cursors so far:" & vbCrLf
    ' Get the Cursors collection from the InkCollector
    Dim theCursors As Cursors = theInkCollector.Cursors
    ' Prevent changes to the collection while we iterate over it.
    SyncLock theCursors.SyncRoot
        theReport &= "Count of cursors: " & theCursors.Count & vbCrLf
        Dim theCursor As Cursor
        For Each theCursor In theCursors
            theReport &= "Cursor Name: " & theCursor.Name & vbCrLf
            theReport &= "Cursor ToString: " & theCursor.ToString() & _
                vbCrLf
            theReport &= "Tablet Name: " & theCursor.Tablet.Name & vbCrLf
            theReport &= "Cursor Id: " & theCursor.Id.ToString() & vbCrLf
            theReport &= "Cursor is inverted: " & _
                theCursor.Inverted.ToString() & vbCrLf
            theReport &= "Cursor Buttons:" & vbCrLf
            Dim theButton As CursorButton
            For Each theButton In theCursor.Buttons
                Dim theState As CursorButtonState = theButton.State
                theReport &= "    Button Name: " & theButton.Name & vbCrLf
                theReport &= "    State: " & _
                    theButton.State.ToString() & vbCrLf
                theReport &= "    Id: " & theButton.Id.ToString() & _
                    vbCrLf & vbCrLf
            Next
        Next
    End SyncLock
    Return theReport
End Function