SetStructElemActualText

pažymėtasis PDF ir prieinamumas

Aprašymas

Nustato /ActualText įrašą struktūros elementui, šiuo metu kuriamam žymų dėkle. ActualText pateikia tiksliąjį Unicode tekstą, kurį atvaizduoja elementas, ir perrašo bet kokį skaitytuvės programinės įrangos iš PDF turinio srauto ištrauktąjį tekstą

Naudokite šią funkciją, kai turinio sraute atvaizduoti glifai tiesiogiai nesutampa su numatytais skaitymo tvarkos simboliais – pvz., ligatūros glifas (ff, fi, fl), kuris turėtų būti skaitomas kaip dviejų simbolių seka ff, fi arba fl. Be ActualText teksto ištraukimo įrankiai ir ekrano skaitytuvai tokiems glifams gali duoti netinkamą išvestį.

Sintaksė

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

Parametrai

Grąžinama reikšmė

Grąžina 1 sėkmės atveju, 0, jei šiuo metu neatvertas joks struktūros elementas arba nepasirinktas joks dokumentas

Pastabos

Iškvieskite šią funkciją iškart po BeginTag arba BeginTagEx, kol tikslinasis elementas yra žymų dėkelio viršuje

ActualText ir AltText atlieka skirtingas paskirtis. AltText (nustatomas per BeginTag AltText parametrą) – alternatyvioji viso elemento atvaizduotė, skirta pagalbinei technologijai, kai vizualiojo turinio atvaizduoti negalima. ActualText papildo turinio srauto teksto ištraukimą: jis pakeičia elemento ištrauktąją simbolių seką, bet neslopina atvaizdavimo. Ekrano skaitytuvės, palaikančios abu, kai jie yra, paprastaiActualText naudoja skaitomajai išvečiai

ISO 32000-1 §14.9.4 apibrėžia ActualText kaip PDF teksto eilutės įrašą struktūros elemento žodyne. PDF/UA-1 (ISO 14289-1 §7.1) reikalauja, kad teksto turinys būtų ištraukiamas ir teisingas; ActualText yra standartinis mechanizmas šiam reikalavimui tenkinti glifų sekoms, kurių tiesioginė ištrauka būtų dviprasmiška ar neteisinga.

Pavyzdys

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

Taip pat žiūrėkite

BeginTag, BeginTagEx, SetStructElemID, AddTagAttribute, GetPDFUADiagnostics