SpeechSynthesizer.SelectVoice(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wählt eine bestimmte Stimme nach Namen aus.
public:
void SelectVoice(System::String ^ name);
public void SelectVoice (string name);
member this.SelectVoice : string -> unit
Public Sub SelectVoice (name As String)
Parameter
- name
- String
Der Name der Stimme, die ausgewählt werden soll.
Hinweise
Verwenden Sie die GetInstalledVoices -Methode und VoiceInfo -Klasse, um die Namen der installierten TTS-Stimmen (Text-to-Speech) abzurufen, die Sie auswählen können. Um eine Stimme auszuwählen, übergeben Sie den gesamten Inhalt der Name Eigenschaft als Argument für die SelectVoice -Methode. Das SpeechSynthesizer -Objekt wählt die erste installierte Stimme aus, die in der -Eigenschaft der Stimme enthalten name
ist VoiceInfo.Name . Führt SpeechSynthesizer einen Vergleich zwischen Groß-/Kleinschreibung und Teilzeichenfolge aus, um zu bestimmen, ob die Stimme mit übereinstimmt name
.
Wenn eine Anwendung aufruft GetInstalledVoices, überprüft die -Methode, ob jede der in der Registrierung gefundenen Stimmen bestimmte Mindestkriterien erfüllt. Legt für jede Stimme, bei der die Überprüfung fehlschlägt, GetInstalledVoices die Enabled -Eigenschaft auf fest False
. Eine Anwendung kann keine Stimme auswählen, deren Enabled Eigenschaft ist False
. In der Regel legen Anwendungen die Eigenschaft einer Stimme Enabled nicht fest.
Um eine Stimme nach Geschlecht, Alter oder Gebietsschema auszuwählen, verwenden Sie eine der SelectVoiceByHints Methoden.