SetStructElemActualText

Címkézett PDF & akadálymentesség

Leírás

Beállítja a címkeveremben jelenleg létrehozás alatt álló struktúraelem /ActualText bejegyzését. Az ActualText megadja az elem által képviselt pontos Unicode-szöveget, felülírva a PDF-tartalomadatfolyamból az olvasószoftver által kinyert szöveget

Használja ezt a függvényt, ha a tartalomadatfolyamban megjelenített karakterjelek nem képezhetők közvetlenül a kívánt olvasási sorrend szerinti karakterekre — például a kétkarakteres ff, fi vagy fl sorozatként olvasandó ligatúrajelre (ff, fi, fl). ActualText nélkül a szövegkinyerő eszközök és a képernyőolvasók hibás kimenetet adhatnak az ilyen karakterjelekhez

Szintaxis

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

Paraméterek

Visszatérési érték

Siker esetén 1-et ad vissza, 0-t, ha jelenleg nincs nyitott struktúraelem vagy nincs kiválasztott dokumentum

Megjegyzések

Ezt a függvényt közvetlenül a BeginTag vagy a BeginTagEx hívása után hívja, miközben a célelem a címkeverem tetején van

Az ActualText és az AltText eltérő célokat szolgál. Az AltText (a BeginTag AltText paraméterével állítható be) a teljes elem alternatív ábrázolása, amely segítő technológia számára készült, ha a vizuális tartalom nem renderelhető. Az ActualText kiegészíti a tartalomadatfolyam szövegkinyerését: lecseréli az elem kinyert karaktersorozatát, de nem nyomja el a megjelenítést. Azokat támogató képernyőolvasók jelenléte esetén jellemzően az ActualText értéket használják felolvasáshoz

Az ISO 32000-1 §14.9.4 az ActualText elemet a struktúraelem-szótár PDF-szövegkarakterlánc-bejegyzéseként határozza meg. A PDF/UA-1 (ISO 14289-1 §7.1) előírja, hogy a szöveges tartalom kinyerhető és helyes legyen; az ActualText szabványos mechanizmus az olyan karakterjelsorozatok követelményének teljesítésére, amelyek közvetlen kinyerése kétértelmű vagy helytelen lenne

Példa

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

Lásd még

BeginTag, BeginTagEx, SetStructElemID, AddTagAttribute, GetPDFUADiagnostics