SpeechSynthesizer.SelectVoice(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.