Choices::ToGrammarBuilder Method ()

.NET Framework (current version)

Returns a GrammarBuilder object from this Choices object.

Namespace: System.Speech.Recognition
Assembly: System.Speech (in System.Speech.dll)

Syntax

public:
GrammarBuilder^ ToGrammarBuilder()

Return Value

Type: System.Speech.Recognition::GrammarBuilder^

A GrammarBuilder that matches this Choices object.

Remarks

The GrammarBuilder returned by this method is equivalent to one returned by either of the following.

Calling the GrammarBuilder constructor with this object as the parameter.
Using the implicit or explicit cast of this object to a GrammarBuilder.

Examples

The following example creates a speech recognition grammar for changing the background color.


private Grammar CreateColorChoice()
{

  // Create a Choices object that contains a set of alternative colors.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});

  // Construct the phrase.
  GrammarBuilder gb = new GrammarBuilder();
  gb.Append(new Choices(new string[] {"Set", "Change"}));
  gb.Append("background to");
  gb.Append(colorChoice.ToGrammarBuilder());

  Grammar grammar = new Grammar(gb);
  grammar.Name = "modify background color";

  return grammar;
}

Version Information

.NET Framework
Available since 3.0