SetStructElemTitleA

Tagged PDF & tilgængelighed

Beskrivelse

Det afsluttende A angiver ANSI-indgangspunktet (char) i DLL'en; ActiveX/COM-overfladen eksponerer kun Unicode-formen. Adfærden er identisk med SetStructElemTitle, og strengargumenter fortolkes ud fra den aktuelle kodetabel i SetAnsiMode

Angiver posten /T (titel) på det strukturelement, der aktuelt opbygges på tagstakken. Titlen er en menneskeligt læsbar etiket, som karakteriserer det konkrete element — f.eks. Kapitel 1, Oversigtstabel eller Figur 3: Kvartalsvist salg — i stedet for blot at gentage elementtypen.

Syntaks

Delphi

Function DLSetStructElemTitleA(InstanceID: Integer; Title: PAnsiChar): Integer;

DLL

int DLSetStructElemTitleA(int InstanceID, const char * Title);

Parametre

Title	En menneskeligt læsbar tekststreng, der identificerer denne bestemte elementinstans. Angiv en tom streng for at rydde en tidligere angivet værdi.

Returværdi

Returnerer 1 ved succes, 0 hvis intet strukturelement er åbent, eller intet dokument er valgt

Bemærkninger

/T-posten er defineret i ISO 32000-1 §14.7.2 Table 324. Den skrives som en PDF-tekststreng i strukturelementets ordbog.

Title har et særskilt formål i forhold til de øvrige tekstegenskaber på et strukturelement:

/T (Title) — En beskrivende etiket for elementet, som bruges i navigations- og taggingpaneler. Velegnet til sektionsoverskrifter, tabeltekster og figurtekster.
/Alt (se SetStructElemAltText) — En komplet tekstlig erstatning for elementet til hjælpeteknologi, når elementet ikke kan gengives.
/ActualText (se SetStructElemActualText) — En nøjagtig Unicode-erstatning for glyfsekvenser, hvis udtrukne tekst ellers ville være forkert.

PDF-fremvisere bruger /T til at navngive elementer i navigationspanelet Tags. Tilgængelighedsværktøjer og reparationssoftware bruger den som en landemærketitel til dokumentnavigation. For overskriftselementer (H1–H6) fungerer selve elementindholdet som overskriftstekst; /T er mere nyttig for elementer uden tekst (Table, Figure, Form) eller beholdere (Sect, Div), der har brug for en beskrivende etiket.

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