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

定義

テキストを PromptBuilder オブジェクトに追加します。Appends text to the PromptBuilder object.

オーバーロード

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

PromptBuilder オブジェクトに追加されるテキストを指定します。Specifies text to append to the PromptBuilder object.

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

PromptBuilder オブジェクトにテキストを追加し、テキストの強調の度合いを指定します。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)

PromptBuilder オブジェクトにテキストを追加し、テキストの読み上げ速度を指定します。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)

PromptBuilder オブジェクトにテキストを追加し、テキストの音量を指定します。Appends text to the PromptBuilder object and specifies the volume to speak the text.

AppendText(String) AppendText(String) AppendText(String) 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 String String 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) AppendText(String, PromptEmphasis) AppendText(String, PromptEmphasis) 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 String String String

読み上げるテキストを含む文字列。A string containing the text to be spoken.

emphasis
PromptEmphasis PromptEmphasis PromptEmphasis 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) AppendText(String, PromptRate) AppendText(String, PromptRate) 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 String String String

読み上げるテキストを含む文字列。A string containing the text to be spoken.

rate
PromptRate PromptRate PromptRate 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) AppendText(String, PromptVolume) AppendText(String, PromptVolume) 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 String String String

読み上げるテキストを含む文字列。A string containing the text to be spoken.

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

注釈

ExtraLoudDefault 設定は、PromptVolumeと同じです。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.

適用対象