SetStructElemTitle

Tagged PDF ja saavutettavuus

Kuvaus

Asettaa /T-tietueen (otsikko) tagipinossa parhaillaan rakennettavalle rakennetyylielementille. Otsikko on ihmisluettava nimike, joka kuvaa tiettyä elementtiä — esimerkiksi Luku 1, Yhteenvetotaulukko tai Kuva 3: Neljännesvuosimyynti — pelkän elementtityypin toistamisen sijaan

Syntaksi

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

Parametrit

Title	Ihmisluettava tekstimerkkijono, joka tunnistaa tämän tietyn elementtiinstanssin. Anna tyhjä merkkijono tyhjentääksesi aiemmin asetetun arvon

Paluuarvo

Palauttaa arvon 1 onnistuessaan, arvon 0, jos mikään rakennetyylielementti ei ole parhaillaan avoinna tai mikään asiakirja ei ole valittuna

Huomautukset

/T-tietue on määritelty standardissa ISO 32000-1 §14.7.2 Table 324. Se kirjoitetaan PDF-tekstimerkkijonona rakennetyylielementin sanakirjaan

Title palvelee eri tarkoitusta kuin rakennetyylielementin muut tekstiominaisuudet:

/T (Title) — Kuvaava nimike elementille navigointi- ja taggauspaneeleissa Sopii osion otsikoille sekä taulukoiden ja kuvien kuvateksteille
/Alt (katso SetStructElemAltText) — Täydellinen tekstivastine elementille avustavalle teknologialle, kun elementtiä ei voi renderöidä
/ActualText (see SetStructElemActualText) — An exact Unicode replacement for glyph sequences whose extracted text would be incorrect.

PDF-katselimet käyttävät /T:tä elementtien nimeämiseen Tags-navigointipaneelissa. Esteellisyystyökalut ja korjausohjelmistot käyttävät sitä maamerkkiotsikkona asiakirjan navigointiin. Otsikkoelementeillä (H1–H6) elementin sisältö itsessään toimii otsikkotekstinä; /T on hyödyllisempi ei-tekstisille elementeille (Table, Figure, Form) tai säiliöille (Sect, Div), jotka tarvitsevat kuvaavan nimikkeen

Esimerkki

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

Katso myös

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics