Partager via


SpeakProgressEventArgs Classe

Définition

Retourne des données de l'événement SpeakProgress.

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
Héritage

Exemples

L’exemple suivant illustre les informations disponibles à partir de SpeakProgressEventArgs. Notez comment les StartParagraphméthodes , EndParagraph, StartSentenceet EndSentence affectent le CharacterCount en ajoutant des <balises p>, </p>, <s> et </s> au SSML généré. En outre, il existe deux entrées dans la sortie pour « 30 % », une pour chaque mot pour parler cette chaîne numérique (trente pour cent). Les CharacterCount et CharacterPosition sont les mêmes pour chaque entrée et représentent les caractères « 30 %. Toutefois, les AudioPosition modifications pour refléter la parole des mots « trente » et « pour cent » par le 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);  
    }  
  }  
}  

Remarques

Une instance de SpeakProgressEventArgs est créée lorsque l’objet SpeechSynthesizer déclenche l’événementSpeakProgress. déclenche SpeechSynthesizer cet événement pour chaque nouveau mot qu’il parle dans une invite à l’aide de l’une Speakdes méthodes , SpeakAsync, SpeakSsmlou SpeakSsmlAsync .

Les données retournées sont basées sur le langage SSML (Speech Synthesis Markup Language) généré par le code. Les valeurs retournées pour CharacterCount incluent les espaces et les caractères et le contenu des balises SSML générées par le code.

Propriétés

AudioPosition

Obtient la position audio de l'événement.

Cancelled

Obtient une valeur qui indique si une opération asynchrone a été annulée.

(Hérité de AsyncCompletedEventArgs)
CharacterCount

Obtient le nombre de caractères du mot qui a été énoncé juste avant le déclenchement de l'événement.

CharacterPosition

Obtient le nombre de caractères et d'espaces à partir du début de l'invite jusqu'à la position précédant la première lettre du mot qui vient d'être énoncé.

Error

Obtient une valeur qui indique quelle erreur s'est produite pendant une opération asynchrone.

(Hérité de AsyncCompletedEventArgs)
Prompt

Obtient l'invite associée à l'événement.

(Hérité de PromptEventArgs)
Text

Texte qui venait d'être énoncé lorsque l'événement a été déclenché.

UserState

Obtient l'identificateur unique de la tâche asynchrone.

(Hérité de AsyncCompletedEventArgs)

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
RaiseExceptionIfNecessary()

Lève une exception fournie par l'utilisateur en cas d'échec d'une opération asynchrone.

(Hérité de AsyncCompletedEventArgs)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à