InkCollector.Cursors 속성

아티클
11/04/2008

업데이트: 2007년 11월

잉크 영역에서 사용할 수 있는 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 개체에서 발견하는 순서대로 커서가 반환되는 것은 아닙니다.

SetAllTabletsMode 메서드의 useMouseForInput 매개 변수가 true인 경우 InkCollector 개체에서 마우스를 입력 장치로 사용하도록 설정하면 InkCollector에서 펜 등의 다른 커서를 발견한 후에 마우스가 Cursors 컬렉션에 추가됩니다. 이는 펜이 마우스처럼 동작하기도 하기 때문입니다.

참고

펜으로 스트로크를 그려 Stroke 이벤트가 발생하는 등의 경우와 같이, CursorInRange 이벤트는 다른 커서 이후에 마우스 커서에 대해 수신됩니다.

다음과 같은 경우 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