PromptBuilder.AppendBookmark(String) Methode

Definition

Fügt eine Textmarke an das PromptBuilder Objekt an.

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

Parameter

bookmarkName
String

Eine Zeichenfolge mit dem Namen der angefügten Textmarke.

Beispiele

Im folgenden Beispiel wird eine Eingabeaufforderung erstellt, die zwei Textmarken enthält und die Ausgabe zur Wiedergabe an eine WAV-Datei sendet. Der Handler für das BookmarkReached Ereignis schreibt den Namen der Textmarke und deren Position im Audiodatenstrom, als das Ereignis in die Konsole ausgelöst wurde.

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.SetOutputToWaveFile(@"C:\test\weather.wav");

        // Create a SoundPlayer instance to play the output audio file.
        System.Media.SoundPlayer m_SoundPlayer =
          new System.Media.SoundPlayer(@"C:\test\weather.wav");

        // Build a prompt and append bookmarks.
        PromptBuilder builder = new PromptBuilder(
          new System.Globalization.CultureInfo("en-US"));
        builder.AppendText(
          "The weather forecast for today is partly cloudy with some sun breaks.");
        builder.AppendBookmark("Daytime forecast");
        builder.AppendText(
          "Tonight's weather will be cloudy with a 30% chance of showers.");
        builder.AppendBookmark("Nighttime forecast");

        // Add a handler for the BookmarkReached event.
        synth.BookmarkReached +=
          new EventHandler<BookmarkReachedEventArgs>(synth_BookmarkReached);

        // Speak the prompt and play back the output file.
        synth.Speak(builder);
        m_SoundPlayer.Play();
      }

      Console.WriteLine();
      Console.WriteLine("Press any key to exit...");
      Console.ReadKey();
    }

    // Write the name and position of the bookmark to the console.
    static void synth_BookmarkReached(object sender, BookmarkReachedEventArgs e)
    {
      Console.WriteLine("Bookmark ({0}) reached at: {1} ",
        e.Bookmark, e.AudioPosition);
    }
  }
}

Hinweise

Ein Sprachsynthesemodul generiert ein BookmarkReached Ereignis, wenn beim Sprechen einer Eingabeaufforderung eine Textmarke mit einer der SpeakMethoden , SpeakAsync, SpeakSsmloder SpeakSsmlAsync Methoden auftritt.

Gilt für: