SpeakProgressEventArgs Klasa

Definicja

Zwraca dane ze SpeakProgress zdarzenia.

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
Dziedziczenie

Przykłady

W poniższym przykładzie przedstawiono informacje dostępne w SpeakProgressEventArgsprogramie . Zwróć uwagę, jak StartParagraphmetody , , EndParagraphStartSentencei EndSentence wpływają na CharacterCount ich dodanie <p>, </p>, <s> i </s> tagów do wygenerowanego SSML. Ponadto istnieją dwa wpisy w danych wyjściowych "30%", po jednym dla każdego wyrazu, aby mówić ten ciąg liczbowy (trzydzieści procent). Wartości CharacterCount i CharacterPosition są takie same dla każdego wpisu i reprezentują znaki "30%. AudioPosition Jednak zmiany odzwierciedlające mówienie słów "trzydzieści" i "procent" przez 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);  
    }  
  }  
}  

Uwagi

Wystąpienie SpeakProgressEventArgs obiektu jest tworzone, gdy SpeechSynthesizer obiekt zgłasza SpeakProgress zdarzenie. Zgłasza SpeechSynthesizer to zdarzenie dla każdego nowego słowa, które mówi w wierszu polecenia przy użyciu dowolnej z Speakmetod , SpeakAsync, SpeakSsmllub SpeakSsmlAsync .

Zwrócone dane są oparte na języku SSML (Speech Synthesis Markup Language), który generuje kod. Wartości zwracane dla CharacterCount spacji oraz znaków i zawartości tagów SSML generowanych przez kod.

Właściwości

AudioPosition

Pobiera pozycję audio zdarzenia.

Cancelled

Pobiera wartość wskazującą, czy operacja asynchroniczna została anulowana.

(Odziedziczone po AsyncCompletedEventArgs)
CharacterCount

Pobiera liczbę znaków w słowie, który został wypowiedziany tuż przed podniesieniem zdarzenia.

CharacterPosition

Pobiera liczbę znaków i spacji od początku monitu do pozycji przed pierwszą literą słowa, który właśnie został wypowiedziany.

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

Tekst, który został właśnie wypowiedziany, gdy zdarzenie zostało podniesione.

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 bieżące wystąpienie.

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

Dotyczy