SrgsOneOf.Add(SrgsItem) Method

Definition

Adds an SrgsItem containing a word or a phrase to the list of alternatives.

public:
 void Add(System::Speech::Recognition::SrgsGrammar::SrgsItem ^ item);
public void Add (System.Speech.Recognition.SrgsGrammar.SrgsItem item);
member this.Add : System.Speech.Recognition.SrgsGrammar.SrgsItem -> unit
Public Sub Add (item As SrgsItem)

Parameters

item
SrgsItem

The item to add to the list of alternatives.

Exceptions

item is null.

Examples

The following example creates a grammar that recognizes the phrase "A nation that has won the World Cup is" followed by the name of a country/region that has won the World Cup. The example uses the SrgsOneOf object to build lists of acceptable country/region names from an array of SrgsItem objects. Using the Add method, the example appends an SrgsItem that contains the string "Italy" to the SrgsOneOf object oneOfEurope.

public void WorldSoccerWinners ()
{

  // Create an SrgsDocument, create a new rule
  // and set its scope to public.
  SrgsDocument document = new SrgsDocument();
  SrgsRule winnerRule = new SrgsRule("WorldCupWinner");
  winnerRule.Scope = SrgsRuleScope.Public;

  // Add the introduction.
  winnerRule.Elements.Add(new SrgsItem("A nation that has won the world cup is: "));

  // Create the rule for the European nations.
  SrgsOneOf oneOfEurope = new SrgsOneOf(new SrgsItem[] {new SrgsItem("England"),
    new SrgsItem("France"), new SrgsItem("Germany")});
  oneOfEurope.Add(new SrgsItem("Italy"));
  SrgsRule ruleEurope = (new SrgsRule("EuropeanNations", new SrgsElement[] {oneOfEurope}));

  // Create the rule for the South American nations.
  SrgsOneOf oneOfSAmerica = new SrgsOneOf(new SrgsItem[] {new SrgsItem("Argentina"),
    new SrgsItem("Brazil"), new SrgsItem("Uruguay")});
  SrgsRule ruleSAmerica = (new SrgsRule("SouthAmericanNations", new SrgsElement[] {oneOfSAmerica}));

  // Add references to winnerRule for ruleEurope and ruleSAmerica.
  winnerRule.Elements.Add(new SrgsOneOf(new SrgsItem[] {(new SrgsItem
    (new SrgsRuleRef(ruleEurope))), new SrgsItem(new SrgsRuleRef(ruleSAmerica))}));

  // Add all the rules to the document and make winnerRule
  // the root rule of the document.
  document.Rules.Add(new SrgsRule[] {winnerRule, ruleEurope, ruleSAmerica});
  document.Root = winnerRule;
}

Applies to

See also