SetStructElemAltText

PDF sa oznakama i pristupačnost

Opis

Postavlja unos /Alt na strukturni element koji se trenutno gradi na steku oznaka. Alternativni tekst je tekstualni opis koji asistivna tehnologija (čitači ekrana, brajevi displeji) prikazuje korisnicima kada element ne može da se prikaže vizuelno — na primer, slika, figura ili matematička formula.

Ova funkcija je istovetna prosleđivanju nepraznog argumenta AltText funkciji BeginTag ili BeginTagEx, ali omogućava da se alternativni tekst postavi ili ažurira nakon otvaranja elementa. Korisna je kad se opis računa ili dohvata asinhrono, nakon što je tip elementa poznat

Sintaksa

Delphi

Function TPDFlib.SetStructElemAltText(Const AltText: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemAltText(AltText As String) As Long

DLL

int DLSetStructElemAltText(int InstanceID, const wchar_t * AltText);

Parametri

AltText	Opis alternativnog teksta 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, dok je ciljni element na vrhu steka tagova, ili bilo kada pre odgovarajućeg poziva EndTag

AltText i ActualText imaju različite namene. AltText je potpuni tekstualni zamenik za ceo element — on zamenjuje vizuelni sadržaj korisnicima koji ne mogu da sagledaju prikazani izlaz. ActualText (ISO 32000-1 §14.9.4) daje tačnu sekvencu Unicode znakova za glifove u liniji teksta čije bi izdvojeni tekst inače bio netačan (kao što su ligature), i ne zamenjuje iscrtavanje. Čitači ekrana tipično izgovaraju AltText za elemente Figure i Formula, a ActualText koriste za ispravke na nivou znakova.

ISO 32000-1 §14.9.3 definiše unos /Alt. PDF/UA-1 (ISO 14289-1 §7.5) zahteva alternativne opise na strukturnim elementima Figure i Formula. GetPDFUADiagnostics prijavljuje kod problema FIGURE-NO-ALT:N kada elementima Figure ili Formula nedostaje Alt tekst.

Primer

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

Vidi takođe

BeginTag, BeginTagEx, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics