SetStructElemExpansionA

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 SetStructElemExpansion, og strengargumenter fortolkes ud fra den aktuelle kodetabel i SetAnsiMode

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 DLSetStructElemExpansionA(InstanceID: Integer; Expansion: PAnsiChar): Integer;

DLL

int DLSetStructElemExpansionA(int InstanceID, const char * 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