AddTagAttributeA

标记 PDF、可访问性

描述

末尾的 A 表示 ANSI（char）DLL 入口点，ActiveX/COM 接口仅公开 Unicode 形式。其行为与 AddTagAttribute 相同，字符串参数会按照当前的 SetAnsiMode 代码页进行解释

向当前在标记栈中构建的结构元素添加具名属性。保存文档时，该属性会写为 PDF /A 属性字典（或字典数组）。请在 BeginTag 或 BeginTagEx 之后、EndTag 之前调用此方法

语法

Delphi

Function DLAddTagAttributeA(InstanceID: Integer; Owner, Name, Value: PAnsiChar): Integer;

DLL

int DLAddTagAttributeA(int InstanceID, const char * Owner, const char * Name, const char * Value);

参数

Owner	ISO 32000-1 表 348 定义的属性所有者名称（例如 `Layout`、`Table`、`List`、`PrintField`）。它会成为属性字典中的 `/O` 键
Name	给定所有者的属性名称（例如 Layout 的 `BBox`、Table 的 `Scope`）不得为空
Value	作为字符串的属性值。仅包含以空格分隔数字的值（例如 `"0 0 200 100"`）会写为 PDF 实数数组。其他任何值会写为 PDF 名称对象（不带前导 `/`）。不得为空

返回值

成功时返回 1。未打开文档、当前未打开标签，或 Owner 或 Name 为空时返回 0

备注

对同一开放标记多次调用 AddTagAttribute 会累积属性当属性属于单一所有者时，库会写入一个 /A 属性字典使用多个所有者时，属性会按所有者分组，并写入为属性字典数组

对于常见属性，可使用便捷包装器 SetStructElemScope 和 SetStructElemBBox，而非直接调用 AddTagAttribute

打开新标签时会重置属性；子元素不会继承这些属性

示例

// Mark a table header cell with column scope
PDFlib.BeginTag('TH', '', '', '');
PDFlib.AddTagAttribute('Table', 'Scope', 'Column');
// ... draw cell content
PDFlib.EndTag;

// Mark a figure with a bounding box
PDFlib.BeginTag('Figure', 'Company logo', '', '');
PDFlib.AddTagAttribute('Layout', 'BBox', '72 600 200 700');
PDFlib.EndTag;

另请参阅

BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox