Freigeben über


PromptBuilder.AppendBookmark(String) Methode

Definition

Fügt ein Lesezeichen 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 des angefügten Lesezeichens.

Beispiele

Im folgenden Beispiel wird eine Eingabeaufforderung erstellt, die zwei Lesezeichen enthält, und sendet die Ausgabe zur Wiedergabe an eine WAV-Datei. Der Handler für das BookmarkReached Ereignis schreibt den Namen des Lesezeichens und seine Position im Audiodatenstrom, wenn 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

Eine Sprachsynthese-Engine generiert ein BookmarkReached Ereignis, wenn beim Sprechen einer Eingabeaufforderung mithilfe einer der SpeakMethoden , , SpeakAsyncSpeakSsmloder SpeakSsmlAsync ein Lesezeichen angezeigt wird.

Gilt für: