Compartilhar via


SpeechSynthesizer.SelectVoice(String) Método

Definição

Seleciona uma voz específica por nome.

public:
 void SelectVoice(System::String ^ name);
public void SelectVoice (string name);
member this.SelectVoice : string -> unit
Public Sub SelectVoice (name As String)

Parâmetros

name
String

O nome da voz a ser selecionada.

Comentários

Use o GetInstalledVoices método e a VoiceInfo classe para obter os nomes das vozes de conversão de texto em fala (TTS) instaladas que você pode selecionar. Para selecionar uma voz, passe todo o conteúdo da Name propriedade como o argumento para o SelectVoice método. O SpeechSynthesizer objeto seleciona a primeira voz instalada que contém name na propriedade da voz VoiceInfo.Name . O SpeechSynthesizer executa uma comparação de subcadeia de caracteres que diferencia maiúsculas de minúsculas para determinar se a voz corresponde ao name .

Quando um aplicativo chama GetInstalledVoices , o método verifica se cada uma das vozes encontradas no registro atende a certos critérios mínimos. Para qualquer voz que falha na verificação, GetInstalledVoices define sua Enabled propriedade como False . Um aplicativo não pode selecionar uma voz cuja Enabled propriedade é False . Normalmente, os aplicativos não definirão a propriedade de uma voz Enabled .

Para selecionar uma voz por gênero, idade ou localidade, use um dos SelectVoiceByHints métodos.

Aplica-se a

Confira também