SemanticResultValue.ToGrammarBuilder Methode

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

Retouren

Retourneert een exemplaar van GrammarBuilder het huidige SemanticResultValue exemplaar.

Voorbeelden

In het volgende voorbeeld worden objecten gemaakt Grammar die ondersteuning bieden voor opdrachten om de achtergrondkleur te wijzigen.

Een Choices object (colorChoice) met de lijst met opties voor achtergrondkleuren wordt gevuld met behulp van de Add(GrammarBuilder[]) methode met GrammarBuilder exemplaren die worden verkregen uit de ToGrammarBuilder() methode op de SemanticResultValue objecten die zijn gemaakt op basis van kleurtekenreeksen.

Een GrammarBuilder wordt vervolgens verkregen door een SemanticResultKey instantie aan te roepenToGrammarBuilder(), die wordt gebruikt om de semantische keuzes in het colorChoice exemplaar te versleutelen.

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;
}

Opmerkingen

Het gebruik van ToGrammarBuilder is gelijk aan het gebruik van de GrammarBuilder constructor die een SemanticResultValue als argument (GrammarBuilder(SemanticResultValue)) gebruikt.