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	Заместващ текст за съдържание, чието визуално представяне се различава от логическото му значение (съответства на PDF атрибута `/ActualText`) Подайте празен низ, ако не е необходим

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

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

Маркирането на документ го отбелязва като маркиран при записване, което е нужно на четеца, преди изобщо да третира структурата като налична Зададената от извикващия стойност на SetMarkInfo се запазва без промяна