SetStructElemExpansion

Tagged PDF ja saavutettavuus

Kuvaus

Asettaa /E-tietueen (laajennusteksti) tagipinossa parhaillaan rakennettavalle rakennetyylielementille. Laajennusteksti on elementin sisältämän lyhenteen tai akronyymin täysin kirjoitettu muoto — esimerkiksi World Wide Web Span-elementille, jonka sisältö lukee WWW, tai International Organization for Standardization ISO:n sisältävälle Spanille

Ruudunlukijat ja muu avustava teknologia lukevat laajennetun tekstin yrittämättä ääntää lyhennettyjä merkkejä, mikä on olennaista lyhenteille, joita ei voi lukea sanoiksi

Syntaksi

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

Parametrit

Expansion	Nykyisen rakennetyylielementin lyhenteen tai akronyymin täysin laajennettu teksti. Anna tyhjä merkkijono tyhjentääksesi aiemmin asetetun arvon

Paluuarvo

Palauttaa arvon 1 onnistuessaan, arvon 0, jos mikään rakennetyylielementti ei ole parhaillaan avoinna tai mikään asiakirja ei ole valittuna

Huomautukset

Kutsu tätä funktiota heti BeginTag-kutsun jälkeen, kun kohdeelementti on tagipinon päällä, tai milloin tahansa ennen vastaavaa EndTag-kutsua

/E-tietue on määritelty standardissa ISO 32000-1 §14.9.5. Se kirjoitetaan PDF-tekstimerkkijonona rakennetyylielementin sanakirjaan ja eroaa muista tekstiominaisuuksista:

/E (Expansion) — Lyhenteen tai akronyymin kokonaan kirjoitettu muoto. Käytetään lyhennetyn inline-sisällön ääntämiseen ruudunlukuohjelmissa
/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) edellyttää, että jokaisen tekstin luonnollinen kieli on yksiselitteisesti määritettävissä. Lyhenteille ja akronyymeille, joiden lyhennettyä muotoa ei voi lukea sanana, /E on vakioto mekanismi tuen toimittamiseen

Sovella /E:tä sisimmälle elementille, joka käärii lyhenteen — tyypillisesti Span-elementille. Laajennus koskee vain kyseisen elementin sisältöä, eivät lapset peri sitä

Esimerkki

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

Katso myös

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics