Proprietà RecognitionResult.TopConfidence

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene il livello di probabilità della proprietà TopAlternate dell'oggetto RecognitionResult.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public ReadOnly Property TopConfidence As RecognitionConfidence
'Utilizzo
Dim instance As RecognitionResult
Dim value As RecognitionConfidence

value = instance.TopConfidence

public RecognitionConfidence TopConfidence { get; }

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

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

public function get TopConfidence () : RecognitionConfidence

Valore proprietà

Tipo: Microsoft.Ink.RecognitionConfidence
Livello di probabilità della proprietà TopAlternate dell'oggetto RecognitionResult.

Note

Tra i sistemi di riconoscimento Microsoft®, solo il Riconoscimento grafia inglese (USA) Microsoft e il Riconoscimento movimenti Microsoft supportano i livelli di probabilità. I livelli di probabilità non sono supportati da tutti i sistemi di riconoscimento di terze parti.

Esempi

In questo esempio il riconoscimento sincrono viene gestito in risposta a un'azione dell'utente, ad esempio il clic su una voce di menu o su un pulsante. Innanzitutto, l'insieme Strokes di un oggetto RecognizerContext viene assegnato dall'insieme Strokes associato a un oggetto InkOverlay e viene verificato il conteggio dei tratti. Se l'insieme Strokes contiene almeno un oggetto Stroke, il processo di riconoscimento inizia con una chiamata al metodo Recognize. Se il riconoscimento ha esito positivo e TopConfidence (se supportato) non è uguale a RecognitionConfidencePoor, ovvero è Intermediate o Strong, l'oggetto TopString viene visualizzato aggiungendolo a una casella di riepilogo.

' assign strokes collection from the collected strokes
Me.mRecognizerContext.Strokes = Me.mInkOverlay.Ink.Strokes
' check stroke count. Recognize() will throw exception if no strokes
If (Me.mRecognizerContext.Strokes.Count > 0) Then
    Dim status As RecognitionStatus
    ' perform the recognition
    Dim rResult As RecognitionResult = Me.mRecognizerContext.Recognize(status)
    ' see if the recognizer used supports confidence levels
    Dim rSupportsConfidence As Boolean = RecognizerSupportsConfidence(mRecognizerContext.Recognizer)
    ' check status and TopConfidence (if supported)
    If (RecognitionStatus.NoError = status And _
        ((rSupportsConfidence And _
         rResult.TopConfidence <> RecognitionConfidence.Poor) Or _
         Not rSupportsConfidence)) Then
        listBoxRecognitionResults.Items.Add(rResult.TopString)
    End If
End If

// assign strokes collection from the collected strokes
this.mRecognizerContext.Strokes = this.mInkOverlay.Ink.Strokes;
// check stroke count. Recognize() will throw exception if no strokes
if (this.mRecognizerContext.Strokes.Count > 0)
{
    RecognitionStatus status;
    // perform the recognition
    RecognitionResult rResult = this.mRecognizerContext.Recognize(out status);
    // see if the recognizer used supports confidence levels
    bool rSupportsConfidence = RecognizerSupportsConfidence(mRecognizerContext.Recognizer);
    // check status and TopConfidence (if supported)
    if (RecognitionStatus.NoError == status &&
        ((rSupportsConfidence &&
         rResult.TopConfidence != RecognitionConfidence.Poor) ||
         !rSupportsConfidence))
    {
        listBoxRecognitionResults.Items.Add(rResult.TopString);
    }
}

Nell'esempio seguente viene illustrato il metodo di supporto utilizzato per determinare se Recognizer supporta i livelli di probabilità.

Private Function RecognizerSupportsConfidence(ByVal pRecognizer As Recognizer) As Boolean
    For Each G As Guid In pRecognizer.SupportedProperties
        If G = RecognitionProperty.ConfidenceLevel Then
            Return True
        End If
    Next
    Return False
End Function

private bool RecognizerSupportsConfidence(Recognizer pRecognizer)
{
    foreach (Guid G in pRecognizer.SupportedProperties)
    {
        if (G == RecognitionProperty.ConfidenceLevel)
        {
            return true;
        }
    }
    return false;
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.