SetStructElemActualText

PDF sa oznakama i pristupačnost

Opis

Postavlja /ActualText unos na elementu strukture koji se trenutno gradi na steku tagova. ActualText daje tačan Unicode tekst koji element predstavlja i nadjačava sav tekst izvučen iz PDF content stream-a pomoću softvera za čitanje

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 (ﬀ, ﬁ, ﬂ) 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

ActualText	Unicode tekstualni string koji se vezuje za trenutni strukturni element. Prosledite prazan string da obrišete ranije postavljenu vrednost

Povratna vrednost

Vraća 1 pri uspehu, 0 ako trenutno nije otvoren nijedan strukturni element ili nije izabran dokument

Napomene

Pozovite ovu funkciju odmah nakon BeginTag ili BeginTagEx, dok je ciljni element na vrhu steka tagova

ActualText i AltText služe različitim svrhama. AltText (koji se postavlja parametrom AltText funkcije BeginTag) je alternativni prikaz celog elementa namenjen asistivnim tehnologijama kad vizuelni sadržaj ne može da se prikaže. ActualText dopunjuje izvlačenje teksta iz content stream-a: zamenjuje izvučeni niz znakova elementa, ali ne sprečava renderovanje. Čitači ekrana koji podržavaju oba obično koriste ActualText za čitanje na glas kad postoji

ISO 32000-1 §14.9.4 definiše ActualText kao unos PDF tekstualnog stringa u rečniku strukturnog elementa. PDF/UA-1 (ISO 14289-1 §7.1) zahteva da se tekstualni sadržaj može izdvojiti i da bude ispravan; ActualText je standardni mehanizam za ispunjenje tog zahteva kod sekvenci glifova čije bi direktno izdvajanje bilo dvosmisleno ili netačno.

Primer

// 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đe

BeginTag, BeginTagEx, SetStructElemID, AddTagAttribute, GetPDFUADiagnostics