SemanticResultKey.ToGrammarBuilder Methode

Definition

Gibt eine Instanz von GrammarBuilder erstellt aus der aktuellen SemanticResultKey Instanz zurück.

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

Gibt zurück

Eine Instanz, die GrammarBuilder aus der aktuellen SemanticResultKey Instanz erstellt wurde.

Beispiele

Im folgenden Beispiel wird ein Grammar Objekt erstellt, das Befehle unterstützt, um die Hintergrundfarbe zu ändern.

Ein Choices Objekt (colorChoice), das die Liste der Optionen für Hintergrundfarben enthält, wird mit der Add(GrammarBuilder[]) Methode mit GrammarBuilder Instanzen gefüllt. Die GrammarBuilder Instanzen werden über die ToGrammarBuilder() Methode für die objekte abgerufen, die SemanticResultValue aus Farbzeichenfolgen erstellt wurden.

A GrammarBuilder wird dann durch Aufrufen ToGrammarBuilder() einer SemanticResultKey Instanz abgerufen, die zum Schlüssel der semantischen Auswahl verwendet colorChoicewird.

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

Hinweise

Die Verwendung entspricht der Verwendung des ToGrammarBuilder Konstruktors, der GrammarBuilder als Argument (GrammarBuilder(SemanticResultKey)) verwendet SemanticResultKey wird.

Gilt für: