BookmarkReachedEventArgs Класс

Определение

Пространство имен:

System.Speech.Synthesis

Сборка:

System.Speech.dll

Пакет:

System.Speech v9.0.0-preview.3.24172.9

Исходный код:

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

Комментарии

Экземпляр BookmarkReachedEventArgs создается, SpeechSynthesizer когда объект вызывает BookmarkReached событие . Вызывает SpeechSynthesizer событие при обнаружении BookmarkReached закладки при обработке Speakлюбого из методов , SpeakAsync, SpeakSsmlили SpeakSsmlAsync . Чтобы получить имя и расположение закладки, которая вызвала событие, получите доступ к свойствам 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)