Freigeben über


BookmarkReachedEventArgs Klasse

Definition

Gibt Daten von dem BookmarkReached-Ereignis zurück.

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
Vererbung

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 instance von BookmarkReachedEventArgs wird erstellt, wenn das SpeechSynthesizer -Objekt das BookmarkReached -Ereignis auslöst. Löst SpeechSynthesizer das BookmarkReached -Ereignis aus, wenn es beim Verarbeiten einer der SpeakMethoden , SpeakAsync, SpeakSsmloder SpeakSsmlAsync auf ein Lesezeichen stößt. Um den Namen und die Position des Lesezeichens abzurufen, das das Ereignis ausgelöst hat, greifen Sie auf die Bookmark Eigenschaften und AudioPosition im Handler für das Ereignis zu.

Eigenschaften

AudioPosition

Ruft den Uhrzeitwert ab, an dem das Lesezeichen erreicht wurde.

Bookmark

Ruft den Namen des Lesezeichens ab, das erreicht wurde.

Cancelled

Ruft einen Wert ab, der angibt, ob ein asynchroner Vorgang abgebrochen wurde.

(Geerbt von AsyncCompletedEventArgs)
Error

Ruft einen Wert ab, der angibt, welcher Fehler während eines asynchronen Vorgangs aufgetreten ist.

(Geerbt von AsyncCompletedEventArgs)
Prompt

Ruft die dem Ereignis zugeordnete Eingabeaufforderung ab.

(Geerbt von PromptEventArgs)
UserState

Ruft den eindeutigen Bezeichner der asynchronen Aufgabe ab.

(Geerbt von AsyncCompletedEventArgs)

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
RaiseExceptionIfNecessary()

Löst eine benutzerdefinierte Ausnahme aus, wenn bei einem asynchronen Vorgang ein Fehler aufgetreten ist.

(Geerbt von AsyncCompletedEventArgs)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen