SetStructElemTitle

Tagget PDF & tilgjengelighet

Beskrivelse

Setter /T-oppføringen (tittel) på strukturelementet som for øyeblikket bygges på tagg-stakken. Tittelen er en menneskelesbar etikett som karakteriserer det konkrete elementet — for eksempel Kapittel 1, Sammendragstabell eller Figur 3: Kvartalssalg — i stedet for bare å gjenta elementtypen

Syntaks

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

Parametere

Title	En menneskelesbar tekststreng som identifiserer denne elementinstansen. Oppgi en tom streng for å tømme en tidligere satt verdi

Returverdi

Returnerer 1 ved suksess, 0 hvis ingen strukturelement står åpent eller ingen dokument er valgt

Merknader

/T-oppføringen er definert i ISO 32000-1 §14.7.2 tabell 324. Den skrives som en PDF-tekststreng i strukturelementordboken

Title har et annet formål enn de andre tekstegenskapene på et strukturelement:

/T (Title) — En beskrivende etikett for elementet slik det brukes i navigasjons- og taggingspaneler. Passer for overskrifter, tabelltekster og figurbildetekster
/Alt (se SetStructElemAltText) — En fullstendig tekstlig erstatning for elementet for hjelpeteknologi når elementet ikke kan gjengis
/ActualText (see SetStructElemActualText) — An exact Unicode replacement for glyph sequences whose extracted text would be incorrect.

PDF-visere bruker /T til å merke elementer i taggnavigasjonspanelet. Tilgjengelighetsverktøy og utbedringsprogramvare bruker den som landemerke-tittel for dokumentnavigasjon. For overskriftselementer (H1–H6) fungerer elementinnholdet selv som overskriftstekst; /T er mer nyttig for ikke-tekstlige elementer (Table, Figure, Form) eller containere (Sect, Div) som trenger en beskrivende etikett

Eksempel

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

Se også

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics