PromptBuilder.AppendText Methode

Definition

Fügt Text an das PromptBuilder Objekt an.

Überlädt

Name Beschreibung
AppendText(String)

Gibt Text an, der an das PromptBuilder Objekt angefügt werden soll.

AppendText(String, PromptEmphasis)

Fügt text an das PromptBuilder Objekt an und gibt den Grad der Hervorhebung für den Text an.

AppendText(String, PromptRate)

Fügt Text an das PromptBuilder Objekt an und gibt die Sprechrate für den Text an.

AppendText(String, PromptVolume)

Fügt Text an das PromptBuilder Objekt an und gibt die Lautstärke an, um den Text zu sprechen.

AppendText(String)

Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs

Gibt Text an, der an das PromptBuilder Objekt angefügt werden soll.

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

Parameter

textToSpeak
String

Eine Zeichenfolge, die den zu sprechenden Text enthält.

Beispiele

Im folgenden Beispiel wird ein PromptBuilder Objekt erstellt und eine Textzeichenfolge mithilfe der AppendText Methode angefügt.

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

Hinweise

Wenn Sie Text anfügen möchten, der als SSML-Markupsprache formatiert ist, verwenden Sie AppendSsmlMarkup.

Gilt für:

AppendText(String, PromptEmphasis)

Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs

Fügt text an das PromptBuilder Objekt an und gibt den Grad der Hervorhebung für den Text an.

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)

Parameter

textToSpeak
String

Eine Zeichenfolge, die den zu sprechenden Text enthält.

emphasis
PromptEmphasis

Der Wert für den Hervorhebungs- oder Stresswert, der auf den Text angewendet werden soll.

Hinweise

Die Sprachsynthesemodule in Windows unterstützen derzeit nicht den Hervorhebungsparameter. Das Festlegen von Werten für den Hervorhebungsparameter führt zu keiner hörbaren Änderung der synthetisierten Sprachausgabe.

Gilt für:

AppendText(String, PromptRate)

Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs

Fügt Text an das PromptBuilder Objekt an und gibt die Sprechrate für den Text an.

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)

Parameter

textToSpeak
String

Eine Zeichenfolge, die den zu sprechenden Text enthält.

rate
PromptRate

Der Wert für die Sprachrate, die auf den Text angewendet werden soll.

Beispiele

Im folgenden Beispiel wird ein PromptBuilder Objekt erstellt und Textzeichenfolgen angefügt. Im Beispiel wird die AppendText Methode verwendet, um eine langsame Sprachrate für die hinzugefügte Zeichenfolge anzugeben, die den Inhalt einer Reihenfolge aufzählt.

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

Gilt für:

AppendText(String, PromptVolume)

Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs
Quelle:
PromptBuilder.cs

Fügt Text an das PromptBuilder Objekt an und gibt die Lautstärke an, um den Text zu sprechen.

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)

Parameter

textToSpeak
String

Eine Zeichenfolge, die den zu sprechenden Text enthält.

volume
PromptVolume

Der Wert für die sprechende Lautstärke (Lautheit), die auf den Text angewendet werden soll.

Beispiele

Im folgenden Beispiel wird die AppendText Methode verwendet, um Lautstärkeeinstellungen anzugeben, die für die SpeechSynthesizer Sprachausgabe gelten sollen.

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

Hinweise

Die Default Einstellung für PromptVolume die vollständige Lautstärke ist identisch mit ExtraLoud. Die anderen Einstellungen verringern die Lautstärke der Sprachausgabe relativ zur vollen Lautstärke.

Gilt für: