SetStructElemAltTextA

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

Leírás

A záró A a DLL ANSI-belépési pontját (char) jelöli; az ActiveX/COM felület csak a Unicode formát teszi elérhetővé. A működés megegyezik ezzel: SetStructElemAltText, és a sztringargumentumok a jelenlegi SetAnsiMode kódlap alapján értelmeződnek

Beállítja a címkekészleten jelenleg épülő struktúraelem /Alt bejegyzését. Az alternatív szöveg az a leíró szöveg, amelyet a segítő technológiák (képernyőolvasók, Braille-kijelzők) akkor jelenítenek meg a felhasználóknak, ha az elem vizuálisan nem jeleníthető meg — például kép, ábra vagy matematikai képlet esetén

Ez a függvény egyenértékű a nem üres AltText argumentum BeginTag vagy BeginTagEx függvénynek való átadásával, de lehetővé teszi az alternatív szöveg beállítását vagy frissítését az elem megnyitása után. Hasznos, ha a leírás az elemtípus ismertté válása után aszinkron módon kerül kiszámításra vagy lekérésre

Szintaxis

Delphi

Function DLSetStructElemAltTextA(InstanceID: Integer; AltText: PAnsiChar): Integer;

DLL

int DLSetStructElemAltTextA(int InstanceID, const char * AltText);

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

Hívja ezt a függvényt közvetlenül a BeginTag után, miközben a célelem a címkeverem tetején van, vagy a megfelelő EndTag hívás előtt bármikor

Az AltText és az ActualText eltérő célokat szolgál. Az AltText a teljes elem teljes szöveges helyettesítője — felváltja a vizuális tartalmat azon felhasználók számára, akik nem érzékelik a renderelt kimenetet. Az ActualText (ISO 32000-1 §14.9.4) megadja azon beágyazott betűjelek pontos Unicode-karaktersorozatát, amelyek kinyert szövege másként hibás lenne (például ligatúrák esetén), és nem helyettesíti a renderelést. A képernyőolvasók jellemzően az AltText értéket olvassák fel a Figure és Formula elemekhez, és az ActualText értéket karakterszintű javításokhoz használják

Az ISO 32000-1 §14.9.3 meghatározza a /Alt bejegyzést. A PDF/UA-1 (ISO 14289-1 §7.5) alternatív leírásokat követel meg a Figure és Formula struktúraelemeken. A GetPDFUADiagnostics a FIGURE-NO-ALT:N hibakódot jelenti, ha a Figure vagy Formula elemeknél hiányzik az Alt szöveg

Példa

// Tag an embedded chart image with alternative text
PDFlib.BeginTag('Figure', '', '');
PDFlib.SetStructElemAltText('Bar chart: Q1 sales 120, Q2 sales 145, Q3 sales 98');
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

Lásd még

BeginTag, BeginTagEx, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics