SpokenTextAppend - PDFiumPas

Aggiunge un run parlato mappato a TPdfSpokenText

Syntax

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

Spoken	`TPdfSpokenText` - Chunk che riceve il testo parlato e la voce span
SpokenPart	`WString` - Run di testo passata al motore vocale
Page	`Integer` - Numero di pagina sorgente a base uno
StartIndex	`Integer` - Indice di carattere sorgente FTextPage a base zero
SourceCount	`Integer` - Conteggio dei caratteri sorgente, oppure -1 per usare la lunghezza del run parlato

SpokenTextAppend aggiunge SpokenPart a Spoken.Text e registra un TPdfSpokenSpan che riporta l'offset parlato al testo della pagina

Quando Spoken.Text ha già contenuto, l'helper inserisce uno spazio separatore prima del nuovo run; quel separatore è volutamente non mappato

I nomi delle API, i nomi dei tipi, i nomi dei file e i termini PDF mantengono la loro grafia originale affinché la ricerca nel codice rimanga affidabile
Usa questo helper quando il testo parlato non coincide con la stringa grezza della pagina, ad esempio regioni saltate, chunk per unità di lettura o override di pronuncia

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