PromptBuilder.AppendText Метод

Определение

Добавляет текст в объект PromptBuilder.Appends text to the PromptBuilder object.

Перегрузки

AppendText(String)

Указывает текст, который необходимо добавить в объект PromptBuilder.Specifies text to append to the PromptBuilder object.

AppendText(String, PromptEmphasis)

Добавляет текст в объект PromptBuilder и указывает степень выделения для текста.Appends text to the PromptBuilder object and specifies the degree of emphasis for the text.

AppendText(String, PromptRate)

Добавляет текст в объект PromptBuilder и указывает скорость озвучивания текста.Appends text to the PromptBuilder object and specifies the speaking rate for the text.

AppendText(String, PromptVolume)

Добавляет текст в объект PromptBuilder и указывает громкость озвучивания текста.Appends text to the PromptBuilder object and specifies the volume to speak the text.

AppendText(String)

Указывает текст, который необходимо добавить в объект 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)

Параметры

textToSpeak
String

Строка, содержащая произносимый текст.A string containing the text to be spoken.

Примеры

Следующий пример создает PromptBuilder объект и добавляет текстовую строку AppendText с помощью метода.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();  
    }  
  }  
}  

Комментарии

Чтобы добавить текст, отформатированный как язык разметки SSML AppendSsmlMarkup, используйте.To append text that is formatted as SSML markup language, use AppendSsmlMarkup.

AppendText(String, PromptEmphasis)

Добавляет текст в объект PromptBuilder и указывает степень выделения для текста.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)

Параметры

textToSpeak
String

Строка, содержащая произносимый текст.A string containing the text to be spoken.

emphasis
PromptEmphasis

Значение выделения, которое необходимо применить к тексту.The value for the emphasis or stress to apply to the text.

Комментарии

Модули синтеза речи в Windows в настоящее время не поддерживают параметр выделения.The speech synthesis engines in Windows do not support the emphasis parameter at this time. Установка значений для параметра выделения не приведет к изменению в синтезированном речевом выводе.Setting values for the emphasis parameter will produce no audible change in the synthesized speech output.

AppendText(String, PromptRate)

Добавляет текст в объект PromptBuilder и указывает скорость озвучивания текста.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)

Параметры

textToSpeak
String

Строка, содержащая произносимый текст.A string containing the text to be spoken.

rate
PromptRate

Значение скорости речи, которое необходимо применить к тексту.The value for the speaking rate to apply to the text.

Примеры

В следующем примере создается PromptBuilder объект и добавляются текстовые строки.The following example creates a PromptBuilder object and appends text strings. В примере AppendText метод используется для указания скорости для добавляемой строки, которая перечисляет содержимое заказа.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)

Добавляет текст в объект PromptBuilder и указывает громкость озвучивания текста.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)

Параметры

textToSpeak
String

Строка, содержащая произносимый текст.A string containing the text to be spoken.

volume
PromptVolume

Значение громкости речи, которое необходимо применить к тексту.The value for the speaking volume (loudness) to apply to the text.

Примеры

В следующем примере AppendText метод используется для указания параметров тома SpeechSynthesizer , которые должны применяться к выходным данным речи.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();  
    }  
  }  
}  

Комментарии

Параметр для PromptVolume — это полный том, ExtraLoudкоторый совпадает с. DefaultThe Default setting for PromptVolume is full volume, which is the same as ExtraLoud. Другие параметры уменьшают объем речевого вывода относительно полного тома.The other settings decrease the volume of speech output relative to full volume.

Применяется к