SetStructElemExpansion

PDF etichetat & Accesibilitate

Descriere

Setează intrarea /E (text de expansiune) pe elementul de structură aflat în construcție pe stiva de taguri. Textul de expansiune este forma complet desfășurată a unei abrevieri sau acronime conținute în element — de exemplu World Wide Web pentru un element Span a cărui conținut este WWW, sau International Organization for Standardization pentru un Span care conține ISO

Screen reader-ele și alte tehnologii asistive citesc textul extins în loc să încerce să pronunțe caracterele prescurtate, ceea ce este esențial pentru abrevierile care nu pot fi rostite ca cuvinte

Sintaxă

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

Parametri

Expansion	Textul complet extins al abrevierii sau acronimului din elementul de structură curent. Treceți un șir gol 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

Apelați această funcție imediat după BeginTag, cât timp elementul țintă este în vârful stivei de tag-uri, sau în orice moment înaintea apelului EndTag potrivit

Intrarea /E este definită în ISO 32000-1 §14.9.5. Este scrisă ca șir de text PDF în dicționarul elementului de structură și este distinctă de celelalte proprietăți de text:

/E (Expansion) — Forma desfășurată a unei abrevieri sau a unui acronim. Folosită de screen reader pentru pronunțarea conținutului inline abreviat.
/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) cere ca limba naturală a fiecărei porțiuni de text să fie determinabilă fără ambiguitate. Pentru abrevierile și acronimele a căror formă scurtă nu poate fi rostită ca un cuvânt, /E este mecanismul standard de a furniza această informație

Aplicați /E pe cel mai interior element care învăluie abrevierea — de obicei un element Span. Expansiunea se aplică doar conținutului acelui element și nu este moștenită de copii

Exemplu

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

Consultați și

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics