SemanticResultValue.ToGrammarBuilder Méthode

Définition

Espace de noms:

System.Speech.Recognition

Assembly:

System.Speech.dll

Retourne une instance de GrammarBuilder construite à partir de l'instance SemanticResultValue actuelle.

public:
 System::Speech::Recognition::GrammarBuilder ^ ToGrammarBuilder();

public System.Speech.Recognition.GrammarBuilder ToGrammarBuilder ();

member this.ToGrammarBuilder : unit -> System.Speech.Recognition.GrammarBuilder

Public Function ToGrammarBuilder () As GrammarBuilder

Retours

GrammarBuilder

Retourne une instance de GrammarBuilder construite à partir de l'instance SemanticResultValue actuelle.

Exemples

L’exemple suivant crée des Grammar objets qui prennent en charge des commandes pour modifier la couleur d’arrière-plan.

Un Choices objet ( colorChoice ) contenant la liste des options pour les couleurs d’arrière-plan est rempli à l’aide de la Add(GrammarBuilder[]) méthode avec les GrammarBuilder instances obtenues à partir de la ToGrammarBuilder() méthode sur les SemanticResultValue objets créés à partir des chaînes de couleur.

Un GrammarBuilder est ensuite obtenu en appelant ToGrammarBuilder() sur une SemanticResultKey instance de, qui sera utilisée pour clé les choix sémantiques dans l' colorChoice instance.

private Grammar CreateGrammarBuilderRGBSemantics()   
{  

  // Create a set of choices, each a lookup from a color name to RBG.  
  // Choices constructors do not take a SemanticResultValue parameter, so  
  // cast SemanticResultValue to GrammarBuilder.  
  Choices colorChoice = new Choices();  
  foreach (string colorName in System.Enum.GetNames(typeof(KnownColor)))   
  {  

    // Use implicit conversion of SemanticResultValue to GrammarBuilder.      
    SemanticResultValue colorValue =   
        new SemanticResultValue(colorName, Color.FromName(colorName).ToArgb());  
    colorChoice.Add(colorValue.ToGrammarBuilder());  
  }  

  SemanticResultKey choiceKey = new SemanticResultKey("rgb", colorChoice);  
  GrammarBuilder choiceBuilder = choiceKey.ToGrammarBuilder();  

  // Create two intermediate grammars with an introductory phrase and the  
  // color choice.  
  GrammarBuilder makeBackgroundBuilder = "Make background";  
  makeBackgroundBuilder.Append(choiceBuilder);  

  GrammarBuilder configureBackgroundBuilder = new GrammarBuilder("Configure background as");  
  configureBackgroundBuilder.Append((new SemanticResultKey("rgb", colorChoice)).ToGrammarBuilder());  

  // Create the final grammar, which recognizes either intermediate grammar.  
  Grammar grammar = new Grammar(new Choices(new GrammarBuilder[] { makeBackgroundBuilder, configureBackgroundBuilder }));  
  grammar.Name = "Set Background Color";  

  return grammar;  
}  

Remarques

L’utilisation de ToGrammarBuilder est équivalente à l’utilisation du GrammarBuilder constructeur qui prend un SemanticResultValue comme argument ( GrammarBuilder(SemanticResultValue) ).