SetStructElemExpansion

Маркиран PDF & достъпност

Описание

Задава записа /E (текст за разширение) върху структурния елемент, който в момента се изгражда в стека на таговете. Текстът за разширение е изписаната изцяло форма на абревиатура или акроним в елемента — например World Wide Web за елемент Span, чието съдържание е WWW, или International Organization for Standardization за Span, съдържащ ISO

Екранните четци и другите помощни технологии произнасят текста за разширение, вместо да се опитват да произнесат съкратените знаци, което е важно за абревиатури, които не могат да бъдат прочетени като думи

Синтаксис

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

Параметри

Expansion	Пълният разгънат текст на съкращението или акронима в текущия структурен елемент. Подайте празен низ, за да изчистите предварително зададена стойност

Върната стойност

Връща 1 при успех, 0 ако няма отворен структурен елемент или не е избран документ

Забележки

Извикайте тази функция непосредствено след BeginTag, докато целевият елемент е най-горе в стека на таговете, или по всяко време преди съответния EndTag

Записът /E е дефиниран в ISO 32000-1 §14.9.5. Той се записва като PDF текстов низ в речника на структурния елемент и е различен от другите текстови свойства:

/E (Expansion) — Изписаната изцяло форма на абревиатура или акроним. Използва се за произношението на съкратено вградено съдържание от екранните четци
/Alt (вижте SetStructElemAltText) — Пълно заместително описание за елементи, които не могат да бъдат визуално изобразени (изображения, фигури, формули)
/ActualText (вижте SetStructElemActualText) — Точен Unicode заместител за последователности от глифове, чийто извлечен текст иначе би бил неправилен (лигатури, варианти на глифове)

PDF/UA-1 (ISO 14289-1 §7.2) изисква естественият език на всяка текстова част да може да бъде еднозначно определен. За абревиатури и акроними, при които съкратената форма не може да бъде прочетена като дума, /E е стандартният механизъм за предоставяне на тази информация

Приложете /E върху най-вътрешния елемент, който обхваща абревиатурата — обикновено елемент Span. Разширението се отнася само за съдържанието на този елемент и не се наследява от децата

Пример

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

Вижте също

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics