BookmarkReachedEventArgs 类

定义

命名空间:

System.Speech.Synthesis

程序集:

System.Speech.dll

包:

System.Speech v9.0.0-preview.3.24172.9

Source:

BookmarkEventArgs.cs

从 BookmarkReached 事件返回数据。

public ref class BookmarkReachedEventArgs : System::Speech::Synthesis::PromptEventArgs

public class BookmarkReachedEventArgs : System.Speech.Synthesis.PromptEventArgs

type BookmarkReachedEventArgs = class
    inherit PromptEventArgs

Public Class BookmarkReachedEventArgs
Inherits PromptEventArgs

继承

Object

EventArgs

AsyncCompletedEventArgs

PromptEventArgs

BookmarkReachedEventArgs

示例

以下示例创建一个包含两个书签的提示，并将输出发送到 WAV 文件进行播放。 当事件引发到控制台时， BookmarkReached 事件的处理程序会写入书签的名称及其在音频流中的位置。

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

注解

当 对象引发 事件时SpeechSynthesizer，会创建 的BookmarkReached实例BookmarkReachedEventArgs。 在SpeechSynthesizer处理任何 Speak、 、 SpeakAsync或 SpeakSsmlAsync 方法时遇到书签时，SpeakSsml将引发 BookmarkReached 事件。 若要获取触发事件的书签的名称和位置，请在事件的处理程序中访问 Bookmark 和 AudioPosition 属性。

属性

AudioPosition	获取在书签达到的时间偏移量。
Bookmark	获取所达到的书签的名称。
Cancelled	获取一个值，该值指示异步操作是否已被取消。 (继承自 AsyncCompletedEventArgs)
Error	获取一个值，该值指示异步操作期间发生的错误。 (继承自 AsyncCompletedEventArgs)
Prompt	获取与事件关联的提示。 (继承自 PromptEventArgs)
UserState	获取异步任务的唯一标识符。 (继承自 AsyncCompletedEventArgs)

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
RaiseExceptionIfNecessary()	如果异步操作失败，则引发用户提供的异常。 (继承自 AsyncCompletedEventArgs)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• AppendBookmark(String)