RecognitionEventArgs.Result Property
Gets the results of the speech or DTMF recognition operation.
Namespace: Microsoft.Speech.Recognition
Assembly: Microsoft.Speech (in microsoft.speech.dll)
Syntax
'Declaration
Public ReadOnly Property Result As RecognitionResult
public RecognitionResult Result { get; }
public:
property RecognitionResult^ Result {
RecognitionResult^ get ();
}
/** @property */
public RecognitionResult get_Result ()
public function get Result () : RecognitionResult
Property Value
The RecognitionResult that contains the results of the speech or DTMF recognition operation.
Remarks
The RecognitionResult object provides information about a candidate phrase found by a speech recognition operation through the methods it inherited from RecognizedPhrase.
A list of all candidates, including the best candidate can be obtained from the Alternates property.
Example
The example below shows the use Result to obtain an instance of RecognitionResult, which is then used to display information about the results of a speech recognition operation.
// Displays the semantics, rules, and alternates of the result.
private void DisplayResult(RecognitionEventArgs eventArgs)
{
// Clear results, semantic XML, semantics tree, and alternates.
_recognitionSmlBrowser.Navigate("about:blank");
_semanticsTreeView.Nodes.Clear();
_alternatesListBox.Items.Clear();
_recognitionInfo.Text = null;
_recognizedTextDisplay.Text = null;
//Obtain result from RecognitionEventArg passed in.
if (eventArgs != null && eventArgs.Result != null)
{
RecognitionResult result = eventArgs.Result;
//Set Text color on the basis of the event type passed in.
_recognitionInfo.Text = null;
switch (eventArgs.GetType().ToString())
{
case "Microsoft.Speech.Recognition.SpeechHypothesizedEventArgs":
_recognizedTextDisplay.ForeColor = Color.Black;
_recognizedTextDisplay.Text = result.Text;
_recognitionInfo.Text = null;
break;
case "Microsoft.Speech.Recognition.SpeechRecognitionRejectedEventArgs":
_recognizedTextDisplay.ForeColor = Color.OrangeRed;
_recognizedTextDisplay.Text ="Unable to Recognize Input";
DisplaySemanticsSML(result);
DisplaySemanticsTreeView(result);
_recognitionInfo.Text = null;
break;
case "Microsoft.Speech.Recognition.SpeechRecognizedEventArgs":
_recognizedTextDisplay.ForeColor = Color.Green;
_recognizedTextDisplay.Text = result.Text;
_recognitionInfo.Text =
"Confidence Level: " + result.Confidence + Environment.NewLine
+ "Recognizing Grammar: " + result.Grammar.Name + Environment.NewLine
+ ((result.Grammar.RuleName != null) ? ("Recognizing Rule : " + result.Grammar.RuleName) : "");
DisplaySemanticsSML(result);
DisplaySemanticsTreeView(result);
break;
default:
_recognizedTextDisplay.ForeColor = Color.Black;
break;
}
_recognizedTextDisplay.Show();
_recognitionInfo.Show();
DisplayAlternates(result);
}
}
Thread Safety
All public static (Shared in Visual Basic) members of this type are thread-safe. Instance members are not guaranteed to be thread-safe.
Platforms
Development Platforms
Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Vista Ultimate Edition, Windows Vista Business Edition, Windows Vista Enterprise Edition
Target Platforms
See Also
Reference
RecognitionEventArgs Class
RecognitionEventArgs Members
Microsoft.Speech.Recognition Namespace
RecognitionEventArgs Class
RecognitionEventArgs.Result Property
RecognitionResult