SetStructElemActualText

Označeni PDF & pristupačnost

Opis

Postavlja unos /ActualText na strukturnom elementu koji se trenutačno gradi na stogu oznaka. ActualText daje točan Unicode tekst koji element predstavlja, zamjenjujući svaki tekst koji je softver za čitanje izdvojio iz PDF toka sadržaja

Use this function when the glyphs rendered in the content stream do not directly map to their intended reading-order characters — for example, a ligature glyph (ff, fi, fl) that should read as the two-character sequence ff, fi, or fl. Without ActualText, text-extraction tools and screen readers may produce incorrect output for such glyphs.

Sintaksa

Delphi

Function TPDFlib.SetStructElemActualText(Const ActualText: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemActualText(ActualText As String) As Long

DLL

int DLSetStructElemActualText(int InstanceID, const wchar_t * ActualText);

Parametri

Povratna vrijednost

Povratne vrijednosti 1 on success, 0 if no structure element is currently open or no document is selected.

Napomene

Pozovite ovu funkciju odmah nakon BeginTag ili BeginTagEx, dok se ciljni element nalazi na vrhu stoga oznaka.

ActualText i AltText služe različitim svrhama. AltText (postavlja se parametrom AltText funkcije BeginTag) alternativni je prikaz cijelog elementa namijenjen pomoćnoj tehnologiji kada se vizualni sadržaj ne može renderirati. ActualText dopunjuje izdvajanje teksta iz toka sadržaja: zamjenjuje izdvojeni slijed znakova elementa, ali ne sprječava renderiranje. Čitači zaslona koji podržavaju oboje obično će za čitanje naglas upotrijebiti ActualText kada postoji

ISO 32000-1 §14.9.4 definira ActualText kao unos tekstualnog niza znakova PDF-a u rječniku strukturnog elementa. PDF/UA-1 (ISO 14289-1 §7.1) zahtijeva da se tekstualni sadržaj može izdvojiti i da bude ispravan; ActualText je standardni mehanizam za ispunjenje tog zahtjeva kod slijedova glifa čije bi izravno izdvajanje bilo dvosmisleno ili netočno.

Primjer

// Tag a ligature glyph so that text extraction yields "fi"
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemActualText('fi');
PDFlib.TextOut(x, y, #$FB01);   // U+FB01 LATIN SMALL LIGATURE FI
PDFlib.EndTag;

Vidi također

BeginTag, BeginTagEx, SetStructElemID, AddTagAttribute, GetPDFUADiagnostics