Share via


Choices Classe

Definição

Representa um conjunto de alternativas dentro das restrições de uma gramática de reconhecimento de fala.

public ref class Choices
public class Choices
type Choices = class
Public Class Choices
Herança
Choices

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala para a frase "Definir plano de fundo como colorChoice", em que colorChoice pode ser uma das cores definidas. O GrammarBuilder é usado para definir as restrições para a 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;  
}  

Comentários

Um Choices objeto representa um componente de uma frase que pode ter um dos vários valores. Use essa classe ao criar uma gramática de reconhecimento de fala de um GrammarBuilder objeto.

Por exemplo, um Choices objeto pode representar o componente colorChoice na frase "Alterar a cor para colorChoice", em que os valores aceitáveis para colorChoice são "vermelho" ou "verde" ou "azul".

Observação

Para usar um Choices objeto como um componente opcional em uma frase, crie o objeto e adicione-o Choices a um GrammarBuilder.GrammarBuilder(GrammarBuilder, Int32, Int32) objeto com minRepeat e maxRepeat defina como 0 e 1, respectivamente. Frases que contêm componentes opcionais podem ser reconhecidas se o componente opcional é falado ou não.

A Choices classe serve a mesma função que o one-of elemento XML definido pela SRGS (Especificação de Gramática de Reconhecimento de Fala) versão 1.0 e é semelhante à SrgsOneOf classe no System.Speech.Recognition.SrgsGrammar namespace.

Para obter mais informações sobre como definir uma gramática de reconhecimento de fala, consulte Reconhecimento de Fala.

Construtores

Choices()

Inicializa uma nova instância da classe Choices que contém um conjunto vazio de alternativas.

Choices(GrammarBuilder[])

Inicializa uma nova instância da Choices classe de uma matriz que contém um ou mais objetos GrammarBuilder.

Choices(String[])

Inicializa uma nova instância da Choices classe de uma matriz que contém um ou mais objetos String.

Métodos

Add(GrammarBuilder[])

Adiciona uma matriz que contém um ou mais objetos GrammarBuilder ao conjunto de alternativas.

Add(String[])

Adiciona uma matriz que contém um ou mais objetos String ao conjunto de alternativas.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToGrammarBuilder()

Retorna um objeto GrammarBuilder deste objeto Choices.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também