Gesture.HotPoint, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient le point caractéristique du mouvement, en coordonnées d'espace d'entrée manuscrite.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public ReadOnly Property HotPoint As Point
'Utilisation
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

Valeur de propriété

Type : System.Drawing.Point
Point caractéristique du mouvement, selon les coordonnées de l'espace d'entrée manuscrite.

Notes

Le point caractéristique est celui qui permet de distinguer un mouvement. Il s'agit habituellement du point de l'angle d'un mouvement ou le point du mouvement prévu, par rapport au contenu situé autour de celui-ci. Si aucun point caractéristique n'est détecté dans un mouvement donné, le point caractéristique est le point de départ du mouvement.

Par exemple, le point caractéristique du mouvement Check est le point d'angle et le point caractéristique du mouvement Curlicue, dans l'énumération ApplicationGesture, est le point de départ du trait qui constitue le mouvement.

Pour plus d'informations sur l'utilisation d'un point caractéristique, consultez Using Gestures.

Exemples

Dans cet exemple, un gestionnaire d'événements se déclenche lorsqu'un mouvement d'application est reconnu. Seuls les types ApplicationGesture demandés spécifiquement par l'application (par un appel à la méthode SetGestureStatus) déclencheront l'événement. Lors de l'examen du premier objet Gesture passé au gestionnaire d'événements, si la valeur confiance forte est affectée à la propriété Confidence pour un mouvement de Contrôle, un petit cercle est dessiné autour des coordonnées représentées par la propriété 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;
        }
    }
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.