SpokenTextAppend - PDFiumPas

Tilføjer ét mappet spoken-text-forløb til en TPdfSpokenText-chunk

Syntax

procedure SpokenTextAppend(var Spoken: TPdfSpokenText; const SpokenPart: WString; Page, StartIndex: Integer; SourceCount: Integer = -1);

Spoken	`TPdfSpokenText` - Chunk der modtager spoken-teksten og span-posten
SpokenPart	`WString` - Tekstforløb der overføres til talemotoren
Page	`Integer` - En-baseret kilde-sidenummer
StartIndex	`Integer` - Nulbaseret FTextPage-kilde-tegnindeks
SourceCount	`Integer` - Kilde-tegnantal eller -1 for at bruge længden af det talte forløb

SpokenTextAppend føjer SpokenPart til Spoken.Text og registrerer en TPdfSpokenSpan, der mapper den talte forskydning tilbage til sideteksten

Når Spoken.Text allerede har indhold, indsætter helperen ét separator-mellemrum før det nye forløb; den separator er bevidst umappet

API-navne, typenavne, filnavne og PDF-termer bevarer deres oprindelige stavemåde, så kodsøgning forbliver pålidelig
Brug denne helper, når den talte tekst ikke er den samme som en rå sidestreng, f.eks. ved sprunget-områder, pr.-læseenhed-chunks eller udtale-tilsidesættelser

Spoken.Text := '';
Spoken.Spans := nil;
SpokenTextAppend(Spoken, UnitText, 1, UnitStart, UnitLength);