BookmarkReachedEventArgs Klasa

Definicja

Przestrzeń nazw:

System.Speech.Synthesis

Zestaw:

System.Speech.dll

Zwraca dane ze BookmarkReached zdarzenia.

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

Dziedziczenie

Object

EventArgs

AsyncCompletedEventArgs

PromptEventArgs

BookmarkReachedEventArgs

Przykłady

Poniższy przykład tworzy monit, który zawiera dwie zakładki i wysyła dane wyjściowe do pliku WAV w celu odtwarzania. Procedura obsługi zdarzenia zapisuje nazwę zakładki i jej położenie w strumieniu audio, gdy zdarzenie BookmarkReached zostało podniesione do konsoli.

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

Uwagi

Wystąpienie klasy BookmarkReachedEventArgs jest tworzone, gdy SpeechSynthesizer obiekt zgłasza BookmarkReached zdarzenie. Metoda SpeechSynthesizer wywołuje BookmarkReached zdarzenie, gdy napotka zakładkę podczas przetwarzania dowolnej z Speak metod , , lub SpeakAsync SpeakSsml SpeakSsmlAsync . Aby uzyskać nazwę i lokalizację zakładki, która wyzwoliła zdarzenie, uzyskaj dostęp do właściwości i w Bookmark AudioPosition programie obsługi dla zdarzenia.

Właściwości

AudioPosition	Pobiera przesunięcie czasu, przy którym osiągnięto zakładkę.
Bookmark	Pobiera nazwę zakładki, która została osiągnięta.
Cancelled	Pobiera wartość wskazującą, czy operacja asynchroniczna została anulowana. (Odziedziczone po AsyncCompletedEventArgs)
Error	Pobiera wartość wskazującą, który błąd wystąpił podczas operacji asynchronicznej. (Odziedziczone po AsyncCompletedEventArgs)
Prompt	Pobiera monit skojarzony ze zdarzeniem. (Odziedziczone po PromptEventArgs)
UserState	Pobiera unikatowy identyfikator zadania asynchronicznego. (Odziedziczone po AsyncCompletedEventArgs)

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
RaiseExceptionIfNecessary()	Zgłasza wyjątek dostarczony przez użytkownika, jeśli operacja asynchroniczna nie powiodła się. (Odziedziczone po AsyncCompletedEventArgs)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• AppendBookmark(String)