SemanticResultKey.ToGrammarBuilder Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает экземпляр GrammarBuilder, созданный из текущего SemanticResultKey.
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
Возвращаемое значение
Экземпляр GrammarBuilder, созданный из текущего экземпляра SemanticResultKey
.
Примеры
В следующем примере создается Grammar объект , который поддерживает команды для изменения цвета фона.
Объект Choices (colorChoice
), содержащий список параметров для цветов фона, заполняется с помощью Add(GrammarBuilder[]) метода с GrammarBuilder экземплярами . Экземпляры GrammarBuilder получаются с помощью ToGrammarBuilder() метода для объектов, созданных SemanticResultValue из цветовых строк.
GrammarBuilder Затем получается путем вызова ToGrammarBuilder() для экземпляра SemanticResultKey , который будет использоваться для определения семантических вариантов в 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;
}
Комментарии
Использование ToGrammarBuilder эквивалентно использованию конструктора GrammarBuilder , который принимает SemanticResultKey в качестве аргумента (GrammarBuilder(SemanticResultKey)).