Gesture.Confidence-Eigenschaft

Artikel
10/28/2008

Ruft das Ausmaß des Vertrauens (hoch, mittel oder niedrig) ab, das ein Erkennungsmodul in die Erkennung einer Stiftbewegung besitzt.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public ReadOnly Property Confidence As RecognitionConfidence
'Usage
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

Eigenschaftenwert

Typ: Microsoft.Ink.RecognitionConfidence
Das Ausmaß des Vertrauens (hoch, mittel oder niedrig), das ein Erkennungsmodul in die Erkennung einer Stiftbewegung besitzt.

Hinweise

Hinweis

Die Bewertung des Vertrauens ist für alle Stiftbewegungserkennungsmodule in der aktuellen Version von Windows XP Tablet PC Edition verfügbar.

Eine Liste der Vertrauenswerte, die zurückgegeben werden können, finden Sie unter dem RecognitionConfidence-Enumerationstyp.

Beispiele

In diesem Beispiel wird ein Ereignishandler ausgelöst, wenn eine Anwendungsstiftbewegung erkannt wird. Das Ereignis wird nur von ApplicationGesture-Typen ausgelöst, die von der Anwendung (durch Aufrufen der SetGestureStatus-Methode) ausdrücklich angefordert wurden. Beim Untersuchen des ersten an den Ereignishandler übergebenen Gesture-Objekts wird, wenn die Confidence-Eigenschaft für eine Check-Stiftbewegung auf hohe Zuverlässigkeit festgelegt ist, ein kleiner Kreis um die Koordinaten gezeichnet, die von der HotPoint-Eigenschaft dargestellt werden.

' 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;
        }
    }
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.