SemanticResultKey.ToGrammarBuilder Methode

Definition

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Gibt eine Instanz von GrammarBuilder zurück, die aus der aktuellen SemanticResultKey-Instanz konstruiert wurde.

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

GrammarBuilder

Eine Instanz von GrammarBuilder, die aus der aktuellen SemanticResultKey-Instanz konstruiert wurde.

Beispiele

Im folgenden Beispiel wird ein Grammar Objekt erstellt, das Befehle zum Ändern der Hintergrundfarbe unterstützt.

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

A GrammarBuilder wird dann durch Aufrufen ToGrammarBuilder() einer SemanticResultKey Instanz abgerufen, die verwendet wird, um die semantischen Auswahlmöglichkeiten zu schlüsseln.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;  
}  

Hinweise

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