BeginMarkedContent

标记 PDF、无障碍

描述

通过写入 BDC(带属性列表的标记内容开始)运算符,在当前内容流中打开一个标记内容范围。这通常用于创建结构化(标记)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标记内容范围已成功打开。

备注

要构建符合规范的标记 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;

另请参阅

EndMarkedContent、BeginTag、EndTag