SemanticResultKey.ToGrammarBuilder Méthode

Définition

Espace de noms:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paquet:

System.Speech v9.0.0-preview.3.24172.9

Source:

SemanticResultKey.cs

Retourne une instance de GrammarBuilder construite à partir de l'instance SemanticResultKey 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

Instance de GrammarBuilder construite à partir de l’instance SemanticResultKey actuelle.

Exemples

L’exemple suivant crée un Grammar objet qui prend en charge les 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 GrammarBuilder des instances. Les GrammarBuilder instances sont obtenues via la ToGrammarBuilder() méthode sur les SemanticResultValue objets créés à partir de chaînes de couleur.

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

private Grammar CreateGrammarBuilderRGBSemantics()
{

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

    // Use implicit conversion of SemanticResultValue to GrammarBuilder.
    colorChoice.Add(colorValue.ToGrammarBuilder());
  }
  SemanticResultKey choiceKey = new SemanticResultKey("rgb", colorChoice);
  GrammarBuilder choiceBuilder = choiceKey.ToGrammarBuilder();

  // Create two intermediate grammars with 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 Grammar object, which recognizes either intermediate grammar.
  Grammar grammar = new Grammar(new Choices(new GrammarBuilder[] {makeBackgroundBuilder, configureBackgroundBuilder}));
  grammar.Name = "Make Background /Configure background as";

  return grammar;
}

Remarques

L’utilisation de ToGrammarBuilder équivaut à l’utilisation du GrammarBuilder constructeur qui prend SemanticResultKey comme argument (GrammarBuilder(SemanticResultKey)).