SemanticResultValue.ToGrammarBuilder Método

Definición

Espacio de nombres:

System.Speech.Recognition

Ensamblado:

System.Speech.dll

Devuelve una instancia de GrammarBuilder construida a partir de la instancia de SemanticResultValue actual.

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

Devoluciones

GrammarBuilder

Devuelve una instancia de GrammarBuilder construida a partir de la instancia de SemanticResultValue actual.

Ejemplos

En el ejemplo siguiente Grammar se crean objetos que admiten comandos para cambiar el color de fondo.

Un Choices objeto ( colorChoice ) que contiene la lista de opciones para los colores de fondo se rellena usando el Add(GrammarBuilder[]) método con GrammarBuilder instancias que se obtienen del ToGrammarBuilder() método en los SemanticResultValue objetos creados a partir de cadenas de color.

GrammarBuilderA continuación, se obtiene una llamada a ToGrammarBuilder() en una SemanticResultKey instancia de, que se usará para claves de las opciones semánticas de la colorChoice instancia.

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

Comentarios

El uso de ToGrammarBuilder es equivalente a utilizar el GrammarBuilder constructor que toma SemanticResultValue como argumento ( GrammarBuilder(SemanticResultValue) ).