BookmarkReachedEventArgs Classe

Definizione

Spazio dei nomi:

System.Speech.Synthesis

Assembly:

System.Speech.dll

Pacchetto:

System.Speech v9.0.0-preview.3.24172.9

Origine:

BookmarkEventArgs.cs

Restituisce dati dall'evento 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

Ereditarietà

Object

EventArgs

AsyncCompletedEventArgs

PromptEventArgs

BookmarkReachedEventArgs

Esempio

L'esempio seguente crea un prompt che include due segnalibri e invia l'output a un file WAV per la riproduzione. Il gestore per l'evento BookmarkReached scrive il nome del segnalibro e la relativa posizione nel flusso audio quando l'evento è stato generato nella console.

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

Commenti

Un'istanza di BookmarkReachedEventArgs viene creata quando l'oggetto SpeechSynthesizer genera l'evento BookmarkReached . Genera SpeechSynthesizer l'evento quando rileva un segnalibro durante l'elaborazione SpeakBookmarkReached di uno dei metodi , SpeakAsync, SpeakSsmlo SpeakSsmlAsync . Per ottenere il nome e il percorso del segnalibro che ha attivato l'evento, accedere alle Bookmark proprietà e AudioPosition nel gestore per l'evento.

Proprietà

AudioPosition	Ottiene l'offset dell'ora in cui è stato raggiunto il segnalibro.
Bookmark	Ottiene il nome del segnalibro raggiunto.
Cancelled	Ottiene un valore che indica se un'operazione asincrona è stata annullata. (Ereditato da AsyncCompletedEventArgs)
Error	Ottiene un valore che indica l'errore verificatosi durante un'operazione asincrona. (Ereditato da AsyncCompletedEventArgs)
Prompt	Ottiene il messaggio di richiesta associato all'evento. (Ereditato da PromptEventArgs)
UserState	Ottiene l’identificatore univoco per l'attività asincrona. (Ereditato da AsyncCompletedEventArgs)

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
RaiseExceptionIfNecessary()	Genera un'eccezione fornita dall'utente in caso di errore in un'operazione asincrona. (Ereditato da AsyncCompletedEventArgs)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• AppendBookmark(String)