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;