InkOverlay.CursorOutOfRange 이벤트

아티클
11/04/2008

업데이트: 2007년 11월

커서가 태블릿 컨텍스트의 물리적 감지 범위(영역)에서 벗어날 때 발생합니다.

네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)

구문

‘선언
Public Event CursorOutOfRange As InkCollectorCursorOutOfRangeEventHandler
‘사용 방법
Dim instance As InkOverlay
Dim handler As InkCollectorCursorOutOfRangeEventHandler

AddHandler instance.CursorOutOfRange, handler

public event InkCollectorCursorOutOfRangeEventHandler CursorOutOfRange

public:
 event InkCollectorCursorOutOfRangeEventHandler^ CursorOutOfRange {
    void add (InkCollectorCursorOutOfRangeEventHandler^ value);
    void remove (InkCollectorCursorOutOfRangeEventHandler^ value);
}

/** @event */
public void add_CursorOutOfRange (InkCollectorCursorOutOfRangeEventHandler value)
/** @event */
public void remove_CursorOutOfRange (InkCollectorCursorOutOfRangeEventHandler value)

JScript에서는 이벤트를 지원하지 않습니다.

설명

이벤트 처리기는 이 이벤트에 대한 데이터가 들어 있는 InkCollectorCursorOutOfRangeEventArgs 형식의 인수를 받습니다.

InkCollectorCursorOutOfRangeEventHandler 대리자를 만들 때는 이벤트를 처리할 메서드를 식별합니다. 이벤트를 이벤트 처리기와 연결하려면 대리자의 인스턴스를 해당 이벤트에 추가합니다. 대리자를 제거하지 않는 경우 이벤트가 발생할 때마다 이벤트 처리기가 호출됩니다. 이벤트 관심도는 기본적으로 설정됩니다.

잉크 모드뿐만 아니라 선택 또는 지우기 모드인 경우에도 CursorOutOfRange 이벤트가 발생합니다. 따라서 사용자가 설정하는 편집 모드는 사용자가 직접 모니터링해야 하며 이벤트를 해석하기 전에 모드를 알고 있어야 합니다. 이러한 요구 사항을 적용하면 플랫폼 이벤트를 더 효율적으로 인식하여 플랫폼을 보다 자유롭게 활용할 수 있습니다.

예제

이 예제에서는 CursorOutOfRange 이벤트가 발생할 때 마지막으로 만들어진 스트로크의 색을 빨간색으로 변경합니다.

Private Sub mInkObject_CursorOutOfRange(ByVal sender As Object, ByVal e As InkCollectorCursorOutOfRangeEventArgs)
    Using s As Strokes = mInkObject.Ink.Strokes
        If s.Count > 0 Then
            s(s.Count - 1).DrawingAttributes.Color = Color.Tomato
            ' redraw the ink canvas
            panelInkCanvas.Invalidate()
        End If
    End Using
End Sub

private void mInkObject_CursorOutOfRange(object sender, InkCollectorCursorOutOfRangeEventArgs e)
{
    using (Strokes S = mInkObject.Ink.Strokes)
    {
        if (S.Count > 0)
        {
            S[S.Count - 1].DrawingAttributes.Color = Color.Tomato;
            // redraw the ink canvas
            panelInkCanvas.Invalidate();
        }
    }
}