BeginTagEx

Маркиран PDF, Достъпност

Описание

Отваря структурен елемент на маркиран PDF на текущата страница с изрично зададен езиков атрибут. Идентично на BeginTag, но добавя параметър Lang, който се записва в атрибута /Lang на структурния елемент

Използвайте тази функция за съдържание, чийто език е различен от подразбиращия се език на документа (зададен чрез SetPDFUAMode или SetDocumentLanguage). ISO 14289-1 §7.2 изисква атрибутът /Lang да бъде зададен за всеки текстов сегмент, който не е на основния език на документа

Таговете трябва да са балансирани: всяко извикване на BeginTagEx трябва да бъде последвано от съответно извикване на EndTag. Таговете могат да бъдат вложени

Синтаксис

Delphi

Function TPDFlib.BeginTagEx(Const TagType, AltText, ActualText, Lang: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx(TagType As String, AltText As String, ActualText As String, Lang As String) As Long

DLL

int DLBeginTagEx(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang);

Параметри

TagType	Стандартен тип на PDF структура: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` и др. (вж. ISO 32000-1 §14.8.4)
AltText	Алтернативен текст за изображения и друго нетекстово съдържание (`/Alt` атрибут). Подайте празен низ, ако не е необходим
ActualText	Заместващ текст за съдържание, чиято визуална форма се различава от логическото му значение (`/ActualText` атрибут). Подайте празен низ, ако не е необходим
Lang	Езиков таг по BCP 47 за съдържанието в този елемент, напр. `en-US`, `fr-FR`, `zh-Hans`. Подайте празен низ, за да наследи езика на документа. Когато е непразен, той отменя езика на ниво документ за този елемент и всички негови наследници

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

0	Неуспешно (няма отворен документ)
1	Тагът е отворен успешно

Пример

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;