SetStructElemExpansion

Tagged PDF & tilgængelighed

Beskrivelse

Indstiller posten /E (udvidelsestekst) på det strukturelement, der aktuelt opbygges på tagstakken. Udvidelsesteksten er den fuldt udskrevne form af en forkortelse eller et akronym i elementet — f.eks. World Wide Web for et Span-element med indholdet WWW eller International Organization for Standardization for et Span med indholdet ISO

Skærmlæsere og anden kompenserende teknologi udtaler den udvidede tekst i stedet for at forsøge at udtale de forkortede tegn, hvilket er afgørende for forkortelser, der ikke kan udtales som ord.

Syntaks

Delphi

Function TPDFlib.SetStructElemExpansion(Const Expansion: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemExpansion(Expansion As String) As Long

DLL

int DLSetStructElemExpansion(int InstanceID, const wchar_t * Expansion);

Parametre

Expansion	Den fuldt udskrevne tekst for forkortelsen eller akronymet i det aktuelle strukturelement. 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

Kald denne funktion umiddelbart efter BeginTag, mens målelementet ligger øverst på tagstakken, eller på et hvilket som helst tidspunkt før det tilsvarende kald til EndTag.

Posten /E er defineret i ISO 32000-1 §14.9.5. Den skrives som en PDF-tekststreng i strukturelementets ordbog og adskiller sig fra de andre tekstegenskaber:

/E (Expansion) — Den fuldt udskrevne form af en forkortelse eller et akronym. Bruges til skærmlæseres udtale af forkortet indlejret indhold
/Alt (se SetStructElemAltText) — En fuldstændig erstatningsbeskrivelse for elementer, der ikke kan gengives visuelt (billeder, figurer, formler).
/ActualText (se SetStructElemActualText) — En nøjagtig Unicode-erstatning for glyfsekvenser, hvis udtrukne tekst ellers ville være forkert (ligaturer, glyfvarianter).

PDF/UA-1 (ISO 14289-1 §7.2) kræver, at det naturlige sprog for hvert tekststykke kan bestemmes entydigt. For forkortelser og akronymer, hvor den forkortede form ikke kan læses højt som et ord, er /E standardmekanismen til at angive disse oplysninger

Anvend /E på det inderste element, der omslutter forkortelsen — typisk et Span-element. Udvidelsen gælder kun for elementets indhold og nedarves ikke til underordnede elementer

Eksempel

// Tag an abbreviation with its expansion
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('World Wide Web');
PDFlib.WriteText('WWW');
PDFlib.EndTag;

// Tag a standards acronym
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('International Organization for Standardization');
PDFlib.WriteText('ISO');
PDFlib.EndTag;

Se også

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics