PromptBuilder.AppendText Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.