SetStructElemAltTextA

Označeni PDF, Dostopnost

Opis

Pripona A označuje vstopno točko ANSI (char) za DLL; vmesnik ActiveX/COM izpostavlja le obliko Unicode. Obnašanje je enako kot pri SetStructElemAltText, argumenti nizov pa se tolmačijo s trenutno kodno stranjo SetAnsiMode

Na strukturnem elementu, ki se trenutno gradi na skladu oznak, nastavi vnos /Alt. Nadomestno besedilo je besedilni opis, ki ga pomožna tehnologija (bralniki zaslona, bralne izpisi v Braillovi pisavi) predstavi uporabnikom, kadar elementa ni mogoče vizualno izrisati — na primer slika, figura ali matematična formula

Ta funkcija je enakovredna podaji nepraznega argumenta AltText funkcijama BeginTag ali BeginTagEx, a dovoljuje, da se nadomestno besedilo nastavi ali posodobi šele potem, ko je element odprt. Uporabna je, kadar se opis izračuna ali pridobi asinhrono, potem ko je znana vrsta elementa

Sintaksa

Delphi

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

DLL

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

Parametri

Vrnjena vrednost

Vrne 1 ob uspehu, 0, kadar trenutno ni odprt strukturni element ali ni izbran dokument

Opombe

Funkcijo pokličite takoj za BeginTag, ko je ciljni element na vrhu sklada oznak, ali kadar koli pred ustreznim klicem EndTag

AltText in ActualText služita različnima namenoma. AltText je popolno besedilno nadomestilo za celoten element — zamenja vizualno vsebino za uporabnike, ki izrisanega izhoda ne zaznajo. ActualText (ISO 32000-1 §14.9.4) poda točno zaporedje znakov Unicode za vrstične glife, katerih izluščeno besedilo bi bilo sicer napačno (na primer ligature), in ne zamenja izrisovanja. Bralniki zaslona običajno izgovorijo AltText za elemente Figure in Formula, ActualText pa uporabijo za popravke na ravni znakov

ISO 32000-1 §14.9.3 definira vnos /Alt. PDF/UA-1 (ISO 14289-1 §7.5) zahteva nadomestne opise na strukturnih elementih Figure in Formula. GetPDFUADiagnostics poroča kodo težave FIGURE-NO-ALT:N, kadar elementom Figure ali Formula manjka nadomestno besedilo

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;

Glejte tudi

BeginTag, BeginTagEx, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics