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();  
    }  
  }  
}  

설명

합니다 Default 에 대 한 설정 PromptVolume 은 동일한 전체 볼륨으로 ExtraLoud입니다.The 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.

적용 대상