SetStructElemTitleA

Getagde PDF en toegankelijkheid

Beschrijving

Het achtervoegsel A duidt het ANSI-toegangspunt (char) van de DLL aan; het ActiveX/COM-oppervlak stelt alleen de Unicode-vorm beschikbaar. Het gedrag is identiek aan SetStructElemTitle en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel

Zet de /T-(titel-)entry op het structuurelement dat momenteel op de tagstack wordt opgebouwd. De titel is een voor mensen leesbaar label dat het specifieke element karakteriseert — bijvoorbeeld Hoofdstuk 1, Samenvattende tabel of Figuur 3: Omzet per kwartaal — in plaats van louter het elementtype te herhalen

Syntaxis

Delphi

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

DLL

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

Parameters

Title	Een voor mensen leesbare tekststring die deze specifieke elementinstantie identificeert. Geef een lege string door om een eerder gezette waarde te wissen

Retourwaarde

Geeft bij succes 1 terug, of 0 als er momenteel geen structure-element open is of geen document is geselecteerd

Opmerkingen

De /T-entry is gedefinieerd in ISO 32000-1 §14.7.2 Table 324. Hij wordt als PDF-tekststring in de structuurelementwoordenboek weggeschreven

Title heeft een andere functie dan de andere teksteigenschappen van een structuurelement:

/T (Title) — Een beschrijvend label voor het element, zoals gebruikt in navigatie- en taggingpanelen. Geschikt voor sectiekoppen, tabelonderschriften en figuuronderschriften.
/Alt (zie SetStructElemAltText) — Een volledige tekstvervanging van het element voor hulptechnologie wanneer het element niet kan worden weergegeven.
/ActualText (see SetStructElemActualText) — An exact Unicode replacement for glyph sequences whose extracted text would be incorrect.

PDF-viewers gebruiken /T om elementen in het Tags-navigatiepaneel te labelen. Accessibilitytools en herstelsoftware gebruiken het als herkenningspunttitel voor documentnavigatie. Voor kopelementen (H1–H6) dient de elementinhoud zelf als koptekst; /T is zinvoller voor niet-tekstelementen (Table, Figure, Form) of containers (Sect, Div) die een beschrijvend label nodig hebben

Voorbeeld

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

Zie ook

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics