StateChangedEventArgs Klasse

Definition

public ref class StateChangedEventArgs : EventArgs

public class StateChangedEventArgs : EventArgs

type StateChangedEventArgs = class
    inherit EventArgs

Public Class StateChangedEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

StateChangedEventArgs

Beispiele

Im folgenden Beispiel wird eine freigegebene Spracherkennung erstellt, und anschließend werden zwei Grammatiktypen zum Erkennen bestimmter Wörter und zum Akzeptieren des freien Diktierens erstellt. Im Beispiel werden alle erstellten Grammatiken asynchron in die Erkennung geladen. Ein Handler für das StateChanged Ereignis verwendet die Methode, um die EmulateRecognizeAsync Windows-Erkennung in den Modus "Überwachung" zu versetzen.

using System;
using System.Speech.Recognition;

namespace SampleRecognition
{
  class Program
  {
    private static SpeechRecognizer recognizer;
    public static void Main(string[] args)
    {

      // Initialize a shared speech recognition engine.
      recognizer = new SpeechRecognizer();

      // Add a handler for the LoadGrammarCompleted event.
      recognizer.LoadGrammarCompleted += new EventHandler<LoadGrammarCompletedEventArgs>(recognizer_LoadGrammarCompleted);

      // Add a handler for the SpeechRecognized event.
      recognizer.SpeechRecognized += new EventHandler<SpeechRecognizedEventArgs>(recognizer_SpeechRecognized);

      // Add a handler for the StateChanged event.
      recognizer.StateChanged += new EventHandler<StateChangedEventArgs>(recognizer_StateChanged);

      // Create "yesno" grammar.
      Choices yesChoices = new Choices(new string[] { "yes", "yup", "yah}" });
      SemanticResultValue yesValue =
          new SemanticResultValue(yesChoices, (bool)true);
      Choices noChoices = new Choices(new string[] { "no", "nope", "nah" });
      SemanticResultValue noValue = new SemanticResultValue(noChoices, (bool)false);
      SemanticResultKey yesNoKey =
          new SemanticResultKey("yesno", new Choices(new GrammarBuilder[] { yesValue, noValue }));
      Grammar yesnoGrammar = new Grammar(yesNoKey);
      yesnoGrammar.Name = "yesNo";

      // Create "done" grammar.
      Grammar doneGrammar =
        new Grammar(new Choices(new string[] { "done", "exit", "quit", "stop" }));
      doneGrammar.Name = "Done";

      // Create dictation grammar.
      Grammar dictation = new DictationGrammar();
      dictation.Name = "Dictation";

      // Load grammars to the recognizer.
      recognizer.LoadGrammarAsync(yesnoGrammar);
      recognizer.LoadGrammarAsync(doneGrammar);
      recognizer.LoadGrammarAsync(dictation);

      // Keep the console window open.
      Console.ReadLine();
    }

    // Put the shared speech recognizer into "listening" mode.
    static void  recognizer_StateChanged(object sender, StateChangedEventArgs e)
    {
     if (e.RecognizerState != RecognizerState.Stopped)
      {
        recognizer.EmulateRecognizeAsync("Start listening");
      }
    }

    // Write the grammar name and the text of the recognized phrase to the console.
    static void  recognizer_SpeechRecognized(object sender, SpeechRecognizedEventArgs e)
    {
     Console.WriteLine("Grammar({0}): {1}", e.Result.Grammar.Name, e.Result.Text);

      // Add event handler code here.
    }

    // Handle the LoadGrammarCompleted event.
    static void  recognizer_LoadGrammarCompleted(object sender, LoadGrammarCompletedEventArgs e)
    {
     string grammarName = e.Grammar.Name;
      bool grammarLoaded = e.Grammar.Loaded;
      if (e.Error != null)
      {
        Console.WriteLine("LoadGrammar for {0} failed with a {1}.",
        grammarName, e.Error.GetType().Name);
      }

      // Add exception handling code here.
      Console.WriteLine("Grammar {0} {1} loaded.",
      grammarName, (grammarLoaded) ? "is" : "is not");
    }
  }
}

Hinweise

Das StateChanged Ereignis wird von der SpeechRecognizer Klasse ausgelöst. StateChangedEventArgs abgeleitet von EventArgs und wird an Handler für StateChanged Ereignisse übergeben.

State ist eine schreibgeschützte Eigenschaft. Der Status einer freigegebenen Spracherkennung kann nicht programmgesteuert geändert werden. Benutzer können den Status einer freigegebenen Spracherkennung mithilfe der Benutzeroberfläche der Spracherkennung oder über das Mitglied der Spracherkennung in der Windows-Systemsteuerung ändern.

Sowohl die Einstellungen " Ein " als auch " Ruhezustand " in der Spracherkennungs-UI entsprechen dem Listening Zustand. Die Einstellung "Aus " in der Spracherkennungs-UI Stoppedentspricht .

Weitere Informationen

• StateChanged
• RecognizerState