TextFragment.TextOffset プロパティ

定義

名前空間:

System.Speech.Synthesis.TtsEngine

アセンブリ:

System.Speech.dll

フラグメント内のテキストの開始位置を取得または設定します。

public:
 property int TextOffset { int get(); void set(int value); };

public int TextOffset { get; set; }

member this.TextOffset : int with get, set

Public Property TextOffset As Integer

プロパティ値

Int32

int が返されるか、これを使用して、この読み上げられるフラグメントに関連付けられたテキスト文字列の一部分の、文字の開始位置を設定できます。

例

次の例は、を継承し、、、 TtsEngineSsml 、およびの使用を使用しているカスタム音声合成実装の一部です TextFragment SpeechEventInfo FragmentState TtsEventId 。

の実装 Speak

1. インスタンスの配列を受け取り TextFragment 、 TextFragment 基に Speak なる合成エンジンのメソッドに渡されるインスタンスの新しい配列を作成します。

   は、 TextOffset 新しいインスタンスでを作成するときに、元のでを考慮するために使用され TextLength TextFragment TextToSpeak TextFragment ます。

2. TtsEngineAction Action FragmentState 各インスタンスのプロパティによって返されるのプロパティによって検出された列挙値がの場合 State TextFragment Speak 、実装

   • 読み上げられるテキストの Americanism を Britishisms に変換します。

   • 実装に提供されるインターフェイスのプロパティがイベントの種類をサポートしている場合は、のインスタンスを使用して、 EventInterest ITtsEngineSite WordBoundary SpeechEventInfo シンセサイザーの進行状況メーターを作成するためのイベントを作成します。

3. その後、変更された配列を使用して音声レンダリングエンジンが呼び出され TextFragment ます。

private const int WordBoundaryFlag = 1 << (int)TtsEventId.WordBoundary;  
private readonly char[] spaces = new char[] { ' ', '\t', '\r', '\n' };  
internal struct UsVsUk  
{  
  internal string UK;  
  internal string US;  
}  

override public void Speak (TextFragment [] frags, IntPtr wfx, ITtsEngineSite site)  
{  
  TextFragment [] newFrags=new TextFragment[frags.Length];  

  for (int i=0;i<frags.Length;i++){  
    newFrags[i].State=frags[i].State;  
    //truncate  
    newFrags[i].TextToSpeak = frags[i].TextToSpeak.Substring(frags[i].TextOffset,  
                               frags[i].TextLength);  
    newFrags[i].TextLength = newFrags[i].TextToSpeak.Length;  
    newFrags[i].TextOffset = 0;  
    if (newFrags[i].State.Action == TtsEngineAction.Speak) {  
      //Us to UK conversion  
      foreach (UsVsUk term in TransList) {  
      newFrags[i].TextToSpeak.Replace(term.US, term.UK);  
      }  
      //Generate progress meter events if supported  
      if ((site.EventInterest & WordBoundaryFlag) != 0) {  
      string[] subs = newFrags[i].TextToSpeak.Split(spaces);  

      foreach (string s in subs) {  
        int offset = newFrags[i].TextOffset;  
        SpeechEventInfo spEvent = new SpeechEventInfo((Int16)TtsEventId.WordBoundary,   
                (Int16)EventParameterType.Undefined,   
                 s.Length, new IntPtr(offset));  
        offset += s.Length;  
        if (s.Trim().Length > 0) {  
          SpeechEventInfo[] events = new SpeechEventInfo[1];  
          events[0] = spEvent;  
          site.AddEvents(events, 1);  
        }  
      }  
      }  
    }  
  }  

  _baseSynthesize.Speak(newFrags, wfx, site);  

}  

注釈

このプロパティの既定値は 0 です。