SetStructElemExpansionA

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 SetStructElemExpansion en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel

Stelt de vermelding /E (expansion text) in op het structuurelement dat momenteel op de tagstack wordt opgebouwd. De expansion text is de volledig uitgeschreven vorm van een afkorting of acroniem in het element — bijvoorbeeld World Wide Web voor een Span-element waarvan de inhoud WWW luidt, of International Organization for Standardization voor een Span met ISO

Screenreaders en andere assistieve technologie spreken de expansietekst uit in plaats van te proberen de afgekorte tekens uit te spreken, wat essentieel is voor afkortingen die niet als woord uit te spreken zijn

Syntaxis

Delphi

Function DLSetStructElemExpansionA(InstanceID: Integer; Expansion: PAnsiChar): Integer;

DLL

int DLSetStructElemExpansionA(int InstanceID, const char * Expansion);

Parameters

Expansion	De volledig uitgeschreven tekst van de afkorting of het acroniem in het huidige structuurelement. Geef een lege string door om een eerder ingestelde 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

Roep deze functie direct na BeginTag aan, terwijl het doelelement bovenaan de tagstack staat, of op elk moment vóór de bijbehorende EndTag-aanroep

De /E-entry is gedefinieerd in ISO 32000-1 §14.9.5. Hij wordt als PDF-tekststring in de structuurelementwoordenboek weggeschreven en is onderscheiden van de andere teksteigenschappen:

/E (Expansion) — De uitgeschreven vorm van een afkorting of acroniem. Wordt gebruikt voor de uitspraak door een screenreader van verkorte inline-inhoud
/Alt (see SetStructElemAltText) — A complete substitute description for elements that cannot be rendered visually (images, figures, formulas).
/ActualText (see SetStructElemActualText) — An exact Unicode replacement for glyph sequences whose extracted text would otherwise be incorrect (ligatures, glyph variants).

PDF/UA-1 (ISO 14289-1 §7.2) eist dat de natuurlijke taal van elk stuk tekst eenduidig vaststelbaar is. Voor afkortingen en acroniemen waarvan de verkorte vorm niet als woord uitgesproken kan worden, is /E het standaardmechanisme om die informatie te leveren

Pas /E toe op het binnenste element dat de afkorting omsluit — doorgaans een Span-element. De expansie geldt alleen voor de inhoud van dat element en wordt niet geërfd door children

Voorbeeld

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

Zie ook

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics