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 anhand des Namens aus.
public:
void SelectVoice(System::String ^ name);public void SelectVoice(string name);member this.SelectVoice : string -> unitPublic Sub SelectVoice (name As String)Parameter
- name
- String
Der Name der auszuwählenden Stimme.
Hinweise
Verwenden Sie die GetInstalledVoices Methode und VoiceInfo Klasse, um die Namen der installierten Text-zu-Sprache-Stimmen (TTS) 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 VoiceInfo.Name Stimme enthalten istname. Bei der SpeechSynthesizer Ausführung eines Vergleichs zwischen Groß- und Kleinschreibung und Teilzeichenfolge wird ermittelt, ob die Stimme mit der nameSprache übereinstimmt.
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, die die Überprüfung fehlschlägt, GetInstalledVoices die Enabled Eigenschaft auf False. Eine Anwendung kann keine Stimme auswählen, deren Enabled Eigenschaft lautet False. In der Regel legen Anwendungen die Eigenschaft einer Stimme Enabled nicht fest.
Wenn Sie eine Stimme nach Geschlecht, Alter oder Gebietsschema auswählen möchten, verwenden Sie eine der SelectVoiceByHints Methoden.
