SpeakProgressEventArgs SpeakProgressEventArgs SpeakProgressEventArgs SpeakProgressEventArgs Class

定義

SpeakProgress イベントからのデータを返します。Returns data from the SpeakProgress event.

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
継承

次の例は、からSpeakProgressEventArgs使用できる情報を示しています。The following example demonstrates the information that is available from SpeakProgressEventArgs. StartParagraph CharacterCount <、 、、およびEndSentenceの各メソッドが、p > 、 /p>、< s > の追加によってに与える影響に注意してください。 < EndParagraph StartSentence/s 生成された SSML にタグを > します。 <Note how the StartParagraph, EndParagraph, StartSentence, and EndSentence methods affect the CharacterCount by their addition of <p>, </p>, <s>, and </s> tags to the generated SSML. また、出力には "30%" という2つのエントリがあり、各単語がこの数値文字列を読み上げます (30%)。Also, there are two entries in the output for "30%", one for each word to speak this number string (thirty percent). CharacterCountCharacterPositionは、各エントリで同じであり、"30%" という文字を表します。The CharacterCount and CharacterPosition are the same for each entry and represent the characters "30%. ただし、では、にSpeechSynthesizerよって "30" と "percent" という単語の発音が反映されています。 AudioPositionHowever, the AudioPosition changes to reflect the speaking of the words "thirty" and "percent" by the 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);  
    }  
  }  
}  
  

注釈

SpeakProgressEventArgsインスタンスは、 SpeechSynthesizerオブジェクトがイベントをSpeakProgress発生させたときに作成されます。An instance of SpeakProgressEventArgs is created when the SpeechSynthesizer object raises the SpeakProgress event. SpeechSynthesizer 、、、 SpeakSsmlSpeakのいずれSpeakAsyncかのメソッドを使用してプロンプトで読み上げる新しい単語ごとに、このイベントを発生させます。SpeakSsmlAsyncThe SpeechSynthesizer raises this event for each new word that it speaks in a prompt using any of the Speak, SpeakAsync, SpeakSsml, or SpeakSsmlAsync methods.

返されるデータは、コードが生成する Speech 合成マークアップ言語 (SSML) に基づいています。The returned data is based on the Speech Synthesis Markup Language (SSML) that the code generates. に対しCharacterCountて返される値には、コードによって生成される SSML タグのスペースと文字およびコンテンツが含まれます。The values returned for CharacterCount include spaces and the characters and contents of the SSML tags generated by the code.

プロパティ

AudioPosition AudioPosition AudioPosition AudioPosition

イベントのオーディオの位置を取得します。Gets the audio position of the event.

Cancelled Cancelled Cancelled Cancelled

非同期操作がキャンセルされたかどうかを示す値を取得します。Gets a value indicating whether an asynchronous operation has been canceled.

(Inherited from AsyncCompletedEventArgs)
CharacterCount CharacterCount CharacterCount CharacterCount

イベントが発生した直前に読み上げられた単語の文字数を取得します。Gets the number of characters in the word that was spoken just before the event was raised.

CharacterPosition CharacterPosition CharacterPosition CharacterPosition

プロンプトの最初から、たったいま読み上げられた単語の最初の文字の前の位置までの、文字とスペースの数を取得します。Gets the number of characters and spaces from the beginning of the prompt to the position before the first letter of the word that was just spoken.

Error Error Error Error

非同期操作中に発生したエラーを示す値を取得します。Gets a value indicating which error occurred during an asynchronous operation.

(Inherited from AsyncCompletedEventArgs)
Prompt Prompt Prompt Prompt

イベントに関連付けられているプロンプトを取得します。Gets the prompt associated with the event.

(Inherited from PromptEventArgs)
Text Text Text Text

イベントの発生時に発音されたテキスト。The text that was just spoken when the event was raised.

UserState UserState UserState UserState

非同期タスクの一意の識別子を取得します。Gets the unique identifier for the asynchronous task.

(Inherited from AsyncCompletedEventArgs)

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
RaiseExceptionIfNecessary() RaiseExceptionIfNecessary() RaiseExceptionIfNecessary() RaiseExceptionIfNecessary()

非同期操作が失敗した場合は、ユーザー指定の例外を発生させます。Raises a user-supplied exception if an asynchronous operation failed.

(Inherited from AsyncCompletedEventArgs)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象