SetStructElemAltTextA

Tagged PDF & Accessibility

Descriere

A-ul final denumește punctul de intrare DLL ANSI (char); suprafața ActiveX/COM expune doar forma Unicode. Comportamentul este identic cu SetStructElemAltText, iar argumentele de tip șir sunt interpretate folosind pagina de cod SetAnsiMode curentă

Setează intrarea /Alt pe elementul de structură aflat în constructie pe stiva de taguri. Textul alternativ este descrierea textuală pe care tehnologia asistivă (cititoare de ecran, afișaje braille) o prezintă utilizatorilor când elementul nu poate fi randat vizual — de exemplu, o imagine, o figură sau o formulă matematică

Această funcție este echivalentă cu pasarea unui argument AltText nevid către BeginTag sau BeginTagEx, dar permite setarea sau actualizarea textului alternativ după deschiderea elementului. Este utilă când descrierea este calculată sau preluată asincron după ce tipul elementului este cunoscut

Sintaxă

Delphi

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

DLL

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

Parametri

Valoare returnată

Returnează 1 în caz de succes, 0 dacă niciun element de structură nu este deschis momentan sau niciun document nu este selectat

Remarks

Apelați această funcție imediat după BeginTag, cât timp elementul țintă este în vârful stivei de tag-uri, sau în orice moment înaintea apelului EndTag potrivit

AltText și ActualText au scopuri diferite. AltText este un substitut textual complet pentru întregul element — îl înlocuiește pe conținutul vizual pentru utilizatorii care nu pot percepe rezultatul randat. ActualText (ISO 32000-1 §14.9.4) furnizează secvența exactă de caractere Unicode pentru glifele inline a căror extragere ar fi altfel incorectă (precum ligaturile) și nu înlocuiește randarea. Cititoarele de ecran rostesc de obicei AltText pentru elementele Figure și Formula și folosesc ActualText pentru corecții la nivel de caracter

ISO 32000-1 §14.9.3 definește intrarea /Alt. PDF/UA-1 (ISO 14289-1 §7.5) cere descrieri alternative pe elementele de structură Figure și Formula. GetPDFUADiagnostics raportează codul de problemă FIGURE-NO-ALT:N când elementele Figure sau Formula nu au text Alt

Exemplu

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

Consultați și

BeginTag, BeginTagEx, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics