SpeechSynthesizer.SelectVoice(String) SpeechSynthesizer.SelectVoice(String) SpeechSynthesizer.SelectVoice(String) SpeechSynthesizer.SelectVoice(String) Method

Definición

Selecciona una voz concreta por nombre.Selects a specific voice by name.

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 String String String

Nombre de la voz que se va a seleccionar.The name of the voice to select.

Comentarios

Use el GetInstalledVoices método y VoiceInfo la clase para obtener los nombres de las voces de texto a voz (TTS) instaladas que puede seleccionar.Use the GetInstalledVoices method and VoiceInfo class to obtain the names of installed text-to-speech (TTS) voices that you can select. Para seleccionar una voz, pase todo el contenido de la Name propiedad como argumento para el SelectVoice método.To select a voice, pass the entire contents of the Name property as the argument for the SelectVoice method. El SpeechSynthesizer objeto selecciona la primera voz instalada que contiene name en la propiedad de VoiceInfo.Name la voz.The SpeechSynthesizer object selects the first installed voice that contains name in the voice's VoiceInfo.Name property. Realiza una comparación de subcadenas que distingue entre mayúsculas y minúsculas para determinar namesi la voz coincide con. SpeechSynthesizerThe SpeechSynthesizer performs a case-sensitive, substring comparison to determine if the voice matches the name.

Cuando una aplicación llama GetInstalledVoicesa, el método comprueba que cada una de las voces que encuentra en el registro cumple determinados criterios mínimos.When an application calls GetInstalledVoices, the method verifies that each of the voices it finds in the registry meets certain minimum criteria. Para cualquier voz que produzca un error GetInstalledVoices de comprobación Enabled , establece Falsesu propiedad en.For any voice that fails verification, GetInstalledVoices sets its Enabled property to False. Una aplicación no puede seleccionar una voz Enabled cuya propiedad Falsesea.An application cannot select a voice whose Enabled property is False. Normalmente, las aplicaciones no establecerán la propiedad Enabled de una voz.Typically, applications will not set a voice's Enabled property.

Para seleccionar una voz por sexo, edad o configuración regional, use uno de los SelectVoiceByHints métodos.To select a voice by gender, age, or locale, use one of the SelectVoiceByHints methods.

Se aplica a

Consulte también: