PromptBuilder.AppendText PromptBuilder.AppendText PromptBuilder.AppendText PromptBuilder.AppendText Method

Definición

Anexa texto al objeto PromptBuilder.Appends text to the PromptBuilder object.

Sobrecargas

AppendText(String) AppendText(String) AppendText(String) AppendText(String)

Especifica el texto que se va a anexar al objeto PromptBuilder.Specifies text to append to the PromptBuilder object.

AppendText(String, PromptEmphasis) AppendText(String, PromptEmphasis) AppendText(String, PromptEmphasis) AppendText(String, PromptEmphasis)

Anexa texto al objeto PromptBuilder y especifica el grado de énfasis para el texto.Appends text to the PromptBuilder object and specifies the degree of emphasis for the text.

AppendText(String, PromptRate) AppendText(String, PromptRate) AppendText(String, PromptRate) AppendText(String, PromptRate)

Anexa texto al objeto PromptBuilder y especifica la velocidad con que se va a decir el texto.Appends text to the PromptBuilder object and specifies the speaking rate for the text.

AppendText(String, PromptVolume) AppendText(String, PromptVolume) AppendText(String, PromptVolume) AppendText(String, PromptVolume)

Anexa texto al objeto PromptBuilder y especifica el volumen con que se va a decir el texto.Appends text to the PromptBuilder object and specifies the volume to speak the text.

AppendText(String) AppendText(String) AppendText(String) AppendText(String)

Especifica el texto que se va a anexar al objeto PromptBuilder.Specifies text to append to the PromptBuilder object.

public:
 void AppendText(System::String ^ textToSpeak);
public void AppendText (string textToSpeak);
member this.AppendText : string -> unit
Public Sub AppendText (textToSpeak As String)

Parámetros

textToSpeak
String String String String

Cadena que contiene el texto que se va a decir.A string containing the text to be spoken.

Ejemplos

En el ejemplo siguiente se crea PromptBuilder un objeto y se anexa una cadena de texto AppendText mediante el método.The example that follows creates a PromptBuilder object and appends a text string using the AppendText method.

using System;  
using System.Speech.Synthesis;  

namespace SampleSynthesis  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  

      // Initialize a new instance of the SpeechSynthesizer.  
      using (SpeechSynthesizer synth = new SpeechSynthesizer())  
      {  

        // Configure the audio output.   
        synth.SetOutputToDefaultAudioDevice();  

        // Create a PromptBuilder object and append a text string.  
        PromptBuilder speakText = new PromptBuilder();  
        speakText.AppendText("Say the name of the song you want to hear");  

        // Speak the contents of the prompt.  
        synth.Speak(speakText);  
      }  

      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  

Comentarios

Para anexar texto con formato de lenguaje de marcado SSML, AppendSsmlMarkupuse.To append text that is formatted as SSML markup language, use AppendSsmlMarkup.

AppendText(String, PromptEmphasis) AppendText(String, PromptEmphasis) AppendText(String, PromptEmphasis) AppendText(String, PromptEmphasis)

Anexa texto al objeto PromptBuilder y especifica el grado de énfasis para el texto.Appends text to the PromptBuilder object and specifies the degree of emphasis for the text.

public:
 void AppendText(System::String ^ textToSpeak, System::Speech::Synthesis::PromptEmphasis emphasis);
public void AppendText (string textToSpeak, System.Speech.Synthesis.PromptEmphasis emphasis);
member this.AppendText : string * System.Speech.Synthesis.PromptEmphasis -> unit
Public Sub AppendText (textToSpeak As String, emphasis As PromptEmphasis)

Parámetros

textToSpeak
String String String String

Cadena que contiene el texto que se va a decir.A string containing the text to be spoken.

emphasis
PromptEmphasis PromptEmphasis PromptEmphasis PromptEmphasis

Valor del énfasis que se va a aplicar al texto.The value for the emphasis or stress to apply to the text.

Comentarios

En este momento, los motores de síntesis de voz de Windows no admiten el parámetro énfasis.The speech synthesis engines in Windows do not support the emphasis parameter at this time. El establecimiento de valores para el parámetro énfasis no producirá ningún cambio audible en la salida de voz sintetizada.Setting values for the emphasis parameter will produce no audible change in the synthesized speech output.

AppendText(String, PromptRate) AppendText(String, PromptRate) AppendText(String, PromptRate) AppendText(String, PromptRate)

Anexa texto al objeto PromptBuilder y especifica la velocidad con que se va a decir el texto.Appends text to the PromptBuilder object and specifies the speaking rate for the text.

public:
 void AppendText(System::String ^ textToSpeak, System::Speech::Synthesis::PromptRate rate);
public void AppendText (string textToSpeak, System.Speech.Synthesis.PromptRate rate);
member this.AppendText : string * System.Speech.Synthesis.PromptRate -> unit
Public Sub AppendText (textToSpeak As String, rate As PromptRate)

Parámetros

textToSpeak
String String String String

Cadena que contiene el texto que se va a decir.A string containing the text to be spoken.

rate
PromptRate PromptRate PromptRate PromptRate

Valor de la velocidad de habla que se va a aplicar al texto.The value for the speaking rate to apply to the text.

Ejemplos

En el ejemplo siguiente se PromptBuilder crea un objeto y se anexan cadenas de texto.The following example creates a PromptBuilder object and appends text strings. En el ejemplo se AppendText usa el método para especificar una velocidad de habla lenta para la cadena que se va a agregar, que enumera el contenido de un pedido.The example uses the AppendText method to specify a slow speaking rate for the string being added, which enumerates the contents of an order.

using System;  
using System.Speech.Synthesis;  

namespace SampleSynthesis  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  

      // Initialize a new instance of the SpeechSynthesizer.  
      using (SpeechSynthesizer synth = new SpeechSynthesizer())  
      {  

        // Configure the audio output.   
        synth.SetOutputToDefaultAudioDevice();  

        // Create a PromptBuilder object and add content.  
        PromptBuilder speakRate = new PromptBuilder();  
        speakRate.AppendText("Your order for");  
        speakRate.AppendText("one kitchen sink and one faucet", PromptRate.Slow);  
        speakRate.AppendText("has been confirmed.");  

        // Speak the contents of the SSML prompt.  
        synth.Speak(speakRate);  
      }  

      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  

AppendText(String, PromptVolume) AppendText(String, PromptVolume) AppendText(String, PromptVolume) AppendText(String, PromptVolume)

Anexa texto al objeto PromptBuilder y especifica el volumen con que se va a decir el texto.Appends text to the PromptBuilder object and specifies the volume to speak the text.

public:
 void AppendText(System::String ^ textToSpeak, System::Speech::Synthesis::PromptVolume volume);
public void AppendText (string textToSpeak, System.Speech.Synthesis.PromptVolume volume);
member this.AppendText : string * System.Speech.Synthesis.PromptVolume -> unit
Public Sub AppendText (textToSpeak As String, volume As PromptVolume)

Parámetros

textToSpeak
String String String String

Cadena que contiene el texto que se va a decir.A string containing the text to be spoken.

volume
PromptVolume PromptVolume PromptVolume PromptVolume

Valor del volumen de habla que se va a aplicar al texto.The value for the speaking volume (loudness) to apply to the text.

Ejemplos

En el ejemplo siguiente se AppendText usa el método para especificar la configuración SpeechSynthesizer del volumen que se debe aplicar a la salida de voz.The following example uses the AppendText method to specify volume settings that the SpeechSynthesizer should apply to speech output.

using System;  
using System.Speech.Synthesis;  

namespace SampleSynthesis  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  

      // Initialize a new instance of the SpeechSynthesizer.  
      using (SpeechSynthesizer synth = new SpeechSynthesizer())  
      {  

        // Configure the audio output.   
        synth.SetOutputToDefaultAudioDevice();  

        // Build a prompt that applies different volume settings.  
        PromptBuilder builder = new PromptBuilder();  
        builder.AppendText("This is the default speaking volume.", PromptVolume.Default);  
        builder.AppendBreak();  
        builder.AppendText("This is the extra loud speaking volume.", PromptVolume.ExtraLoud);  
        builder.AppendBreak();  
        builder.AppendText("This is the medium speaking volume.", PromptVolume.Medium);  

        // Speak the prompt.  
        synth.Speak(builder);  
      }  

      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  

Comentarios

El Default valor de PromptVolume es volumen completo, ExtraLoudque es el mismo que.The Default setting for PromptVolume is full volume, which is the same as ExtraLoud. Las demás opciones reducen el volumen de salida de voz en relación con el volumen completo.The other settings decrease the volume of speech output relative to full volume.

Se aplica a