SetStructElemTitle

PDF etichetat & Accesibilitate

Descriere

Setează intrarea /T (titlu) pe elementul de structură aflat în construcție pe stiva de taguri. Titlul este o etichetă lizibilă care caracterizează elementul concret — de exemplu Chapter 1, Summary Table sau Figure 3: Quarterly Sales — nu doar o repetare a tipului elementului

Sintaxă

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	Un șir de text lizibil care identifică această instanță concretă de element. Transmiteți un șir vid pentru a șterge o valoare setată anterior

Valoare returnată

Returnează 1 în caz de succes, 0 dacă niciun element de structură nu este deschis momentan sau niciun document nu este selectat

Observații

Intrarea /T este definită în ISO 32000-1 §14.7.2 Table 324. Este scrisă ca șir de text PDF în dicționarul elementului de structură

Title are un scop distinct față de celelalte proprietăți de text ale unui element de structură:

/T (Title) — Eticheta descriptivă a elementului, folosită în panourile de navigare și de tag-uri. Potrivită pentru titluri de secțiuni, legende de tabele, legende de figuri.
/Alt (vezi SetStructElemAltText) — Un substitut textual complet pentru element, folosit de uneltele de accesibilitate când elementul nu poate fi redat.
/ActualText (see SetStructElemActualText) — An exact Unicode replacement for glyph sequences whose extracted text would be incorrect.

Viewer-urile PDF folosesc /T pentru a eticheta elementele în panoul de navigare Tags. Uneltele de accesibilitate și programele de remediere îl folosesc ca titlu de reper pentru navigarea documentului. Pentru elementele de titlu (H1–H6), conținutul elementului servește drept text al titlului; /T este mai util pentru elementele non-text (Table, Figure, Form) sau pentru containere (Sect, Div) care au nevoie de o etichetă descriptivă

Exemplu

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

Consultați și

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics