InkCollector.Cursors 属性

项目
10/28/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 集合中。这是因为笔的行为类似于鼠标。

备注

如果在任何其他光标之后遇到鼠标光标，如用笔绘制笔画时（将激发 Stroke 事件），将接收到 CursorInRange 事件。

在以下情况下，将清除 Cursors 集合（计数设置为 0，不包含任何对象）：

Tablet 模式发生更改（例如，从 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