Gesture.Confidence, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient le niveau de fiabilité (fort, moyen ou faible) qu'un module de reconnaissance accorde à la reconnaissance d'un mouvement.

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

Syntaxe

'Déclaration
Public ReadOnly Property Confidence As RecognitionConfidence
'Utilisation
Dim instance As Gesture
Dim value As RecognitionConfidence

value = instance.Confidence

public RecognitionConfidence Confidence { get; }

public:
property RecognitionConfidence Confidence {
    RecognitionConfidence get ();
}

/** @property */
public RecognitionConfidence get_Confidence()

public function get Confidence () : RecognitionConfidence

Valeur de propriété

Type : Microsoft.Ink.RecognitionConfidence
Niveau de fiabilité (fort, moyen ou faible) qu'un module de reconnaissance accorde à la reconnaissance d'un mouvement.

Notes

Remarque :
L'évaluation de la fiabilité est disponible pour tous les modules de reconnaissance de mouvements dans la version actuelle de Windows XP Tablet PC.

Pour obtenir la liste des valeurs de confiance qui peuvent être retournées, consultez le type énumération RecognitionConfidence.

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.