GestureAlternate.Confidence Property

GestureAlternate.Confidence Property

Confidence level assigned to this alternate by the gesture recongizer.

Definition

Visual Basic .NET Public ReadOnly Property Confidence As RecognitionConfidence
C# public RecognitionConfidence Confidence { get; }
Managed C++ public: __property RecognitionConfidence* get_Confidence();

Property Value

Microsoft.Ink.RecognitionConfidence.

This property is read-only. This property has no default value.

Strong0 Indicates strong confidence in the result or alternate.
Intermediate1 Indicates intermediate confidence in the result or alternate.
Poor2 Indicates poor confidence in the result or alternate.

Examples

This Microsoft® Visual C#® .NET example is a snippet from the implementation of the IStylusAsyncPlugin interface's CustomStylusDataAdded method. The form which implements the IStylusAsyncPlugin interface contains a TextBox Leave Site object, theTextBox. The CustomStylusDataAdded method checks for custom stylus data from the GestureRecognizer object and displays information about any gesture or gestures that the GestureRecognizer object recognized.

[C#]using Microsoft.Ink;
using Microsoft.StylusInput;
using Microsoft.StylusInput.PluginData;

// ...

// Declare the RealTimeStylus objects, the GestureRecognizer plugin,
// and the DynamicRenderer plug-in.
private Microsoft.StylusInput.RealTimeStylus thePrimaryRealTimeStylus = null;
private Microsoft.StylusInput.RealTimeStylus theSecondaryRealTimeStylus = null;
private Microsoft.StylusInput.GestureRecognizer theGestureRecognizer = null;
private Microsoft.StylusInput.DynamicRenderer theDynamicRenderer = null;

// ...

// Informs the implementing object that user data is available.
public void CustomStylusDataAdded(RealTimeStylus sender, CustomStylusData data)
{
    // We can identify the kind of custom data via either the Guid or Type.
    // For the purpose of this demonstration we will validate both just to be safe.
    // For other scenarios either approach is valid.
    if (data.CustomDataId == GestureRecognizer.GestureRecognitionDataGuid)
    {
        // Cast the custom stylus data to gesture recognition data.
        GestureRecognitionData theData = data.Data as GestureRecognitionData;

        // If there is data in the notification, then display the information
        // for all of the gestures recognized.
        if (theData != null && theData.Count > 0)
        {
            this.theTextBox.Text = "GestureRecognitionData:" + Environment.NewLine;
            foreach (GestureAlternate theGesture in theData)
            {
                this.theTextBox.Text += string.Format(
                    "  Gesture {0,-10}, Confidence {1,-8}, Count {2}."
                    + Environment.NewLine, theGesture.Id,
                    theGesture.Confidence, theGesture.StrokeCount);
            }
            this.theTextBox.Text += Environment.NewLine;
        }
    }
}