Freigeben über


TextFragment.TextOffset Eigenschaft

Definition

Ruft die Startposition des Texts im Fragment ab oder legt diese fest.

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

Eigenschaftswert

Int32

Ein int wird zurückgegeben oder kann verwendet werden, um die Startposition des Teils der Textzeichenfolge, in Zeichen, festzulegen, die diesem zu sprechenden Fragment zugeordnet ist.

Beispiele

Das folgende Beispiel ist Teil einer benutzerdefinierten Sprachsyntheseimplementierung, die von erbt und die Verwendung von TtsEngineSsml TextFragment , , und SpeechEventInfo FragmentState TtsEventId verwendet.

Die Implementierung von Speak

  1. Empfängt ein Array von -Instanzen und erstellt ein neues Array von -Instanzen, das an die -Methode in einer zugrunde TextFragment TextFragment Speak liegenden Synthese-Engine übergeben werden soll.

    Besondere Sorgfalt wird verwendet, um beim Erstellen von auf den neuen Instanzen die -Instanz auf dem TextOffset TextLength TextFragment TextToSpeak TextFragment originalen zu achten.

  2. Wenn der Enumerationswert von aus der -Eigenschaft auf dem gefunden wurde, der von der -Eigenschaft jeder Instanz TtsEngineAction Action zurückgegeben FragmentState State TextFragment Speak wird, ist die -Implementierung.

    • Übersetzt Denamenismus in Britishisms im zu sprechenden Text.

    • Wenn die -Eigenschaft auf den Schnittstellen, die für die Implementierung bereitgestellt werden, den Ereignistyp unterstützt, wird eine -Instanz verwendet, um ein Ereignis zu erstellen, um eine EventInterest ITtsEngineSite Synthetizer-Statusanzeige zu WordBoundary SpeechEventInfo erzeugen.

  3. Eine Sprachrendering-Engine wird dann mit dem geänderten Array TextFragment aufgerufen.

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

}  

Hinweise

Der Standardwert dieser Eigenschaft ist 0.

Gilt für