SpokenTextAppend - PDFium Delphi Component

Tilføjer én kortlagt talt-tekst-run til en TPdfSpokenText-chunk

Syntax

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

Spoken	`TPdfSpokenText` - Chunk that receives the spoken text and span entry
SpokenPart	`WString` - Text run passed to the speech engine
Page	`Integer` - One-based source page number
StartIndex	`Integer` - Zero-based FTextPage source character index
SourceCount	`Integer` - Source character count, or -1 to use the spoken run length

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