BeginMarkedContent
Тегированный PDF, доступность
Описание
Открывает диапазон маркированного содержимого в текущем потоке содержимого, записывая оператор BDC (Begin Marked Content with Property List). Обычно используется для создания структурированного (тегированного) PDF, удовлетворяющего требованиям доступности (таким как PDF/UA)Диапазоны маркированного содержимого должны быть корректно сбалансированы: каждый вызов
BeginMarkedContent должен закрываться соответствующим вызовом EndMarkedContent. Диапазоны маркированного содержимого могут вкладываться
Синтаксис
Delphi
Function TPDFlib.BeginMarkedContent(Const TagType, AltText, ActualText, Lang, Expansion: WideString): Integer;Параметры
| TagType | Имя структурного тега, например /Span, /P, /Figure и т. д. |
|---|---|
| AltText | Альтернативный описательный текст для доступности (отображается на ключ /Alt в списке свойств). Если не нужен, передайте пустую строку |
| ActualText | Фактический текст, заменяющий глифовое представление для программ экранного доступа (отображается на ключ /ActualText). Если не нужен, передайте пустую строку |
| Lang | Код естественного языка для маркированного содержимого (например, en-US, отображается на ключ /Lang). Если не нужен, передайте пустую строку |
| Expansion | Текст развертывания для сокращений или аббревиатур (отображается на ключ /E). Если не нужен, передайте пустую строку |
Возвращаемые значения
| 0 | Документ не открыт либо не удалось записать маркированное содержимое |
|---|---|
| 1 | Диапазон маркированного содержимого успешно открыт |
Примечания
Для создания соответствующих требованиям файлов Tagged PDF/UA следите, чтобы теги логической структуры охватывали весь видимый текст и графику. По сравнению с BeginTag эта функция предлагает более тонкое сопоставление свойств
Пример
// Heading, then a paragraph with marked content span
PDF.NewDocument;
PDF.AddPage;
PDF.BeginMarkedContent('/Span', 'Logo description', '', 'en-US', '');
// Draw graphics or print text here
PDF.EndMarkedContent;