BeginTag

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

Описание

Отваря структурен елемент на маркиран PDF на текущата страница. Записва оператор BDC (Begin Marked Content with Dictionary) в потока със съдържание и регистрира елемента в логическото дърво на структурата на документа. Дървото на структурата се финализира автоматично при записване на документа

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

Синтаксис

Delphi

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

ActiveX

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

DLL

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

Параметри

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

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

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

Пример

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

Бележки

Използвайте BeginArtifact/EndArtifact за декоративно съдържание (заглавия на страници, колонтитули, фонови елементи), което не трябва да се чете от екранни четци

Документът трябва да е в режим на запис (създаден или отворен за модификация). Извикайте SetPDFUAMode преди маркиране, за да изпълните изискванията на PDF/UA-1