SetStructElemTitle

PDF sa oznakama i pristupačnost

Opis

Postavlja unos /T (naslov) na strukturni element koji se trenutno gradi na steku oznaka. Naslov je ljudima čitljiva oznaka koja karakteriše konkretan element — na primer Poglavlje 1, Tabela sažetka ili Slika 3: Kvartalna prodaja — umesto da samo ponavlja tip elementa.

Sintaksa

Delphi

Function TPDFlib.SetStructElemTitle(Const Title: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemTitle(Title As String) As Long

DLL

int DLSetStructElemTitle(int InstanceID, const wchar_t * Title);

Parametri

Title	Tekstualni string čitljiv ljudima koji identifikuje ovu konkretnu instancu elementa. 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

Unos /T definisan je u ISO 32000-1 §14.7.2 Tabela 324. Upisuje se kao PDF tekstualni string u rečnik strukturnog elementa.

Title ima posebnu namenu, različitu od ostalih tekstualnih osobina strukturnog elementa:

/T (Title) — Opisna oznaka elementa kakva se koristi u panelima navigacije i označavanja. Pogodna za naslove odeljaka, naslove tabela i opise slika.
/Alt (vidi SetStructElemAltText) — Potpuni tekstualni zamenik elementa za asistivnu tehnologiju kada element ne može da se prikaže.
/ActualText (see SetStructElemActualText) — An exact Unicode replacement for glyph sequences whose extracted text would be incorrect.

PDF prikazivači koriste /T za označavanje elemenata u panelu navigacije oznaka. Alati pristupačnosti i softver za sanaciju koriste ga kao orijentir za navigaciju dokumentom. Kod naslovnih elemenata (H1–H6) sam sadržaj elementa služi kao tekst naslova; /T je korisniji za netekstualne elemente (Table, Figure, Form) ili kontejnere (Sect, Div) kojima treba opisna oznaka.

Primer

// Tag a data table with a title for navigation and accessibility tools
PDFlib.BeginTag('Table', '', '');
PDFlib.SetStructElemTitle('Table 2: Annual Revenue by Region');
// ... table rows and cells
PDFlib.EndTag;

// Tag a document section
PDFlib.BeginTag('Sect', '', '');
PDFlib.SetStructElemTitle('Chapter 3: Implementation');
// ... section content
PDFlib.EndTag;

Vidi takođe

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics