SpeechSynthesizer.SelectVoice(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Sélectionne une voix spécifique par son nom.
public:
void SelectVoice(System::String ^ name);
public void SelectVoice (string name);
member this.SelectVoice : string -> unit
Public Sub SelectVoice (name As String)
Paramètres
- name
- String
Nom de la voix à sélectionner.
Remarques
Utilisez la GetInstalledVoices méthode et VoiceInfo la classe pour obtenir les noms des voix de synthèse vocale (TTS) installées que vous pouvez sélectionner. Pour sélectionner une voix, passez l’intégralité du contenu de la Name propriété comme argument de la SelectVoice méthode. L’objet SpeechSynthesizer sélectionne la première voix installée qui contient name
dans la propriété de VoiceInfo.Name la voix. Effectue SpeechSynthesizer une comparaison de sous-chaînes respectant la casse pour déterminer si la voix correspond à .name
Lorsqu’une application appelle GetInstalledVoices, la méthode vérifie que chacune des voix qu’elle trouve dans le Registre répond à certains critères minimaux. Pour toute voix qui échoue à la vérification, GetInstalledVoices définit sa Enabled propriété sur False
. Une application ne peut pas sélectionner une voix dont Enabled la propriété est False
. En règle générale, les applications ne définissent pas la propriété d’une Enabled voix.
Pour sélectionner une voix par sexe, âge ou paramètres régionaux, utilisez l’une SelectVoiceByHints des méthodes.