SemanticResultValue.ToGrammarBuilder Metoda

Definice

Obor názvů:

System.Speech.Recognition

Sestavení:

System.Speech.dll

Balíček:

System.Speech v9.0.0-preview.4.24266.19

Zdroj:

SemanticResultValue.cs

Vrátí instanci sestavenou GrammarBuilder z aktuální SemanticResultValue instance.

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

Návraty

GrammarBuilder

Vrátí instanci sestavenou GrammarBuilder z aktuální SemanticResultValue instance.

Příklady

Následující příklad vytvoří Grammar objekty, které podporují příkazy pro změnu barvy pozadí.

Objekt Choices (colorChoice) obsahující seznam možností pro barvy pozadí je vyplněn pomocí Add(GrammarBuilder[]) metody s instancemi GrammarBuilder , které jsou získány z ToGrammarBuilder() metody na SemanticResultValue objekty vytvořené z řetězců barev.

A GrammarBuilder se pak získá voláním ToGrammarBuilder()SemanticResultKey instance, která se použije ke klíči sémantických voleb v colorChoice instanci.

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

Poznámky

Použití parametru ToGrammarBuilder je ekvivalentní použití konstruktoru GrammarBuilder , který jako argument () přijímá SemanticResultValue argument (GrammarBuilder(SemanticResultValue)).