Choices Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa um conjunto de alternativas nas restrições de uma gramática de reconhecimento de fala.
public ref class Choicespublic class Choicestype Choices = classPublic Class Choices- Herança
-
Choices
Exemplos
O exemplo seguinte cria uma gramática de reconhecimento de voz para a frase "Definir o fundo para colorChoice", onde colorChoice pode ser uma das cores definidas. O GrammarBuilder é usado para definir as restrições da gramática.
private Grammar CreateColorGrammar()
{
// Create a Choices object that contains a set of alternative colors.
Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
colorChoice.Add(new string[] {"cyan", "yellow", "magenta"});
// Construct the phrase.
GrammarBuilder builder = new GrammarBuilder("Set background to");
builder.Append(colorChoice);
// Create a grammar for the phrase.
Grammar colorGrammar = new Grammar(builder);
colorGrammar.Name = "SetBackground";
return colorGrammar;
}
Observações
Um Choices objeto representa um componente de uma frase que pode ter um de vários valores. Use esta classe ao criar uma gramática de reconhecimento de fala a partir de um GrammarBuilder objeto.
Por exemplo, um Choices objeto pode representar o componente colorChoice na frase "Mudar a cor para colorChoice", onde os valores aceitáveis para colorChoice são "vermelho", ou "verde", ou "azul".
Note
Para usar um Choices objeto como componente opcional numa frase, crie o Choices objeto e adicione-o a um GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) objeto com minRepeat e maxRepeat definido para 0 e 1, respetivamente. Frases que contêm componentes opcionais podem ser reconhecidas quer a componente opcional seja falada ou não.
A Choices classe desempenha a mesma função do one-of elemento XML definido pela Especificação de Gramática de Reconhecimento de Fala (SRGS) Versão 1.0 e é semelhante à SrgsOneOf classe do System.Speech.Recognition.SrgsGrammar espaço de nomes.
Para mais informações sobre a definição de uma gramática de reconhecimento de fala, consulte Reconhecimento de Fala.
Construtores
| Name | Description |
|---|---|
| Choices() |
Inicializa uma nova instância da Choices classe que contém um conjunto vazio de alternativas. |
| Choices(GrammarBuilder[]) |
Inicializa uma nova instância da Choices classe a partir de um array que contém um ou mais GrammarBuilder objetos. |
| Choices(String[]) |
Inicializa uma nova instância da Choices classe a partir de um array que contém um ou mais String objetos. |
Métodos
| Name | Description |
|---|---|
| Add(GrammarBuilder[]) |
Adiciona um array contendo um ou mais GrammarBuilder objetos ao conjunto de alternativas. |
| Add(String[]) |
Adiciona um array contendo um ou mais String objetos ao conjunto de alternativas. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToGrammarBuilder() |
Devolve um GrammarBuilder objeto a partir desse Choices objeto. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
