Freigeben über


SpeakProgressEventArgs Klasse

Definition

Gibt Daten von dem SpeakProgress-Ereignis zurück.

public ref class SpeakProgressEventArgs : System::Speech::Synthesis::PromptEventArgs
public class SpeakProgressEventArgs : System.Speech.Synthesis.PromptEventArgs
type SpeakProgressEventArgs = class
    inherit PromptEventArgs
Public Class SpeakProgressEventArgs
Inherits PromptEventArgs
Vererbung

Beispiele

Im folgenden Beispiel werden die Informationen veranschaulicht, die in SpeakProgressEventArgsverfügbar sind. Beachten Sie, wie sich die StartParagraphMethoden , EndParagraph, StartSentenceund EndSentence durch hinzufügen von <p>-, /p>-,<<s>- und </s-Tags> zum generierten SSML auf die -Methode auswirkenCharacterCount. Außerdem gibt es zwei Einträge in der Ausgabe für "30%", einen für jedes Wort, das diese Zahlenzeichenfolge spricht (dreißig Prozent). und CharacterCountCharacterPosition sind für jeden Eintrag identisch und stellen die Zeichen "30% dar. Die Änderungen spiegeln jedoch das AudioPosition Sprechen der Wörter "dreißig" und "Prozent" durch wider SpeechSynthesizer.

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 containing a paragraph and two sentences.  
        PromptBuilder builder = new PromptBuilder(  
          new System.Globalization.CultureInfo("en-US"));  
        builder.StartParagraph();  
        builder.StartSentence();  
        builder.AppendText(  
          "The weather forecast for today is partly cloudy with some sun breaks.");  
        builder.EndSentence();  
        builder.StartSentence();  
        builder.AppendText(  
          "Tonight's weather will be cloudy with a 30% chance of showers.");  
        builder.EndSentence();  
        builder.EndParagraph();  

        // Add a handler for the SpeakProgress event.  
        synth.SpeakProgress +=  
          new EventHandler<SpeakProgressEventArgs>(synth_SpeakProgress);  

        // 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 each word and its character position to the console.  
    static void synth_SpeakProgress(object sender, SpeakProgressEventArgs e)  
    {  
      Console.WriteLine("CharPos: {0}   CharCount: {1}   AudioPos: {2}    \"{3}\"",  
        e.CharacterPosition, e.CharacterCount, e.AudioPosition, e.Text);  
    }  
  }  
}  

Hinweise

Eine instance von SpeakProgressEventArgs wird erstellt, wenn das SpeechSynthesizer -Objekt das SpeakProgress -Ereignis auslöst. Löst SpeechSynthesizer dieses Ereignis für jedes neue Wort aus, das in einer Eingabeaufforderung gesprochen wird, indem eine der SpeakMethoden , SpeakAsync, SpeakSsmloder SpeakSsmlAsync verwendet wird.

Die zurückgegebenen Daten basieren auf der Speech Synthesis Markup Language (SSML), die der Code generiert. Die für CharacterCount zurückgegebenen Werte enthalten Leerzeichen sowie die Zeichen und Inhalte der vom Code generierten SSML-Tags.

Eigenschaften

AudioPosition

Ruft die Audioposition des Ereignisses ab.

Cancelled

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

(Geerbt von AsyncCompletedEventArgs)
CharacterCount

Gibt die Anzahl von Zeichen im Wort zurück, das gesprochen wurde, gerade bevor das Ereignis ausgelöst wurde.

CharacterPosition

Ruft die Anzahl von Zeichen und Leerzeichen vom Beginn der Eingabeaufforderung zur Position vor dem ersten Buchstaben des Worts ab, das gerade gesprochen wurde.

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)
Text

Der Text, der gerade gesprochene wurde, als das Ereignis ausgelöst wurde.

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: