SpeechSynthesizer.SelectVoice(String) Methode

Definition

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.

Gilt für:

Weitere Informationen