Gesture.HotPoint 속성

아티클
11/04/2008

업데이트: 2007년 11월

잉크 공간 좌표에 있는 제스처의 핫 포인트를 가져옵니다.

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

구문

‘선언
Public ReadOnly Property HotPoint As Point
‘사용 방법
Dim instance As Gesture
Dim value As Point

value = instance.HotPoint

public Point HotPoint { get; }

public:
property Point HotPoint {
    Point get ();
}

/** @property */
public Point get_HotPoint()

public function get HotPoint () : Point

속성 값

형식: System.Drawing.Point
잉크 공간 좌표에 있는 제스처의 핫 포인트입니다.

설명

핫 포인트는 제스처의 점을 구분하는 점으로, 대개 제스처의 각도 점 또는 제스처가 주변의 콘텐츠와 관련하여 발생하게 되는 점을 나타냅니다. 알려진 제스처에 대해 뚜렷한 핫 포인트가 없는 경우 제스처는 핫 포인트에서 시작하게 됩니다.

예를 들어 Check 제스처의 핫 포인트는 각도 점이고, ApplicationGesture 열거형에 있는 Curlicue 제스처의 핫 포인트는 제스처에 해당하는 스트로크의 시작 부분입니다.

핫 포인트의 사용 방법에 대한 자세한 내용은 Using Gestures을를 참조하십시오.

예제

이 예제에서는 응용 프로그램 제스처가 인식되면 이벤트 처리기가 실행됩니다. 응용 프로그램에서 SetGestureStatus 메서드를 호출하여 특별히 요청한 ApplicationGesture 형식에서만 이벤트가 발생합니다. 이벤트 처리기에 전달된 첫 번째 Gesture 개체를 조사하면서 Confidence 속성이 Check 제스처에 대한 높은 신뢰 수준으로 설정되어 있으면 HotPoint 속성이 나타내는 좌표 주위에 작은 원을 그립니다.

' event handler for InkOverlay.Gesture event
Private Sub mInkObject_Gesture(ByVal sender As Object, ByVal e As InkCollectorGestureEventArgs)
    ' There might be more than one gesture passed in InkCollectorGestureEventArgs
    ' The gestures are arranged in order of confidence from most to least
    ' This event handler is only concerned with the first (most confident) gesture
    ' and only if the first gesture has RecognitionConfidence.Strong
    Dim G As Gesture = e.Gestures(0)

    ' if this is ApplicationGesture.Check of RecognitionConfidence.Strong confidence
    If ApplicationGesture.Check = G.Id And RecognitionConfidence.Strong = G.Confidence Then
        Dim mInkOverlay As InkOverlay = DirectCast(sender, InkOverlay)
        ' assuming here that InkOverlay.AttachedControl property is set.
        ' This can be set with the .ctor InkOverlay(Control C) or the
        ' InkOverlay.AttachedControl property can be set later.
        Using GR As Graphics = mInkOverlay.AttachedControl.CreateGraphics()
            ' get the hot point
            Dim hotPoint As Point = G.HotPoint
            ' convert to pixel coordinates
            mInkOverlay.Renderer.InkSpaceToPixel(GR, hotPoint)
            ' draw a small circle
            GR.DrawEllipse(Pens.Orange, hotPoint.X - 6, hotPoint.Y - 6, 12, 12)
            ' cancel the event. This prevents the gesture from disappearing
            ' and lets you see the small circle and the gesture together
            e.Cancel = True
        End Using
    End If
End Sub

// event handler for InkOverlay.Gesture event
private void mInkObject_Gesture(object sender, InkCollectorGestureEventArgs e)
{
    // There might be more than one gesture passed in InkCollectorGestureEventArgs
    // The gestures are arranged in order of confidence from most to least
    // This event handler is only concerned with the first (most confident) gesture
    // and only if the first gesture has RecognitionConfidence.Strong
    Gesture G = e.Gestures[0];

    // if this is ApplicationGesture.Check of RecognitionConfidence.Strong confidence
    if (ApplicationGesture.Check == G.Id && RecognitionConfidence.Strong == G.Confidence)
    {
        InkOverlay mInkOverlay = (InkOverlay)sender;
        // assuming here that InkOverlay.AttachedControl property is set.
        // This can be set with the .ctor InkOverlay(Control C) or the
        // InkOverlay.AttachedControl property can be set later.
        using (Graphics GR = mInkOverlay.AttachedControl.CreateGraphics())
        {
            // get the hot point
            Point hotPoint = G.HotPoint;
            // convert to pixel coordinates
            mInkOverlay.Renderer.InkSpaceToPixel(GR, ref hotPoint);
            // draw a small circle
            GR.DrawEllipse(Pens.Orange, hotPoint.X - 6, hotPoint.Y - 6, 12, 12);
            // cancel the event. This prevents the gesture from disappearing
            // and lets you see the small circle and the gesture together
            e.Cancel = true;
        }
    }
}