BookmarkReachedEventArgs Klasse

Definition

Gibt Daten aus 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 Textmarken enthält und die Ausgabe zur Wiedergabe an eine WAV-Datei sendet. Der Handler für das BookmarkReached Ereignis schreibt den Namen der Textmarke und deren Position im Audiodatenstrom, als 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 Instanz von BookmarkReachedEventArgs wird erstellt, wenn das SpeechSynthesizer Objekt das BookmarkReached Ereignis auslöst. Das SpeechSynthesizer Ereignis löst das BookmarkReached Ereignis aus, wenn es beim Verarbeiten einer der SpeakMethoden , SpeakAsync, , SpeakSsmloder SpeakSsmlAsync methoden auf eine Textmarke trifft. Um den Namen und die Position der Textmarke abzurufen, die das Ereignis ausgelöst hat, greifen Sie auf die BookmarkAudioPosition Eigenschaften im Handler für das Ereignis zu.

Eigenschaften

Name Beschreibung
AudioPosition

Ruft den Zeitversatz ab, zu dem die Textmarke erreicht wurde.

Bookmark

Ruft den Namen der Textmarke ab, die 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 Eingabeaufforderung ab, die dem Ereignis zugeordnet ist.

(Geerbt von PromptEventArgs)
UserState

Ruft den eindeutigen Bezeichner für die asynchrone Aufgabe ab.

(Geerbt von AsyncCompletedEventArgs)

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
RaiseExceptionIfNecessary()

Löst eine vom Benutzer bereitgestellte Ausnahme aus, wenn ein asynchroner Vorgang fehlgeschlagen ist.

(Geerbt von AsyncCompletedEventArgs)
ToString()

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

(Geerbt von Object)

Gilt für:

Weitere Informationen