SetStructElemTitleA

带标签 PDF & 辅助功能

描述

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

在当前位于 tag stack 顶部的结构元素上设置 /T（title）条目。Title 是标识具体元素的人类可读标签，例如 Chapter 1、Summary Table 或 Figure 3: Quarterly Sales，而不是仅仅重复元素类型

语法

Delphi

Function DLSetStructElemTitleA(InstanceID: Integer; Title: PAnsiChar): Integer;

DLL

int DLSetStructElemTitleA(int InstanceID, const char * Title);

参数

Title	标识这个具体元素实例的人类可读文本字符串。传入空字符串可清除之前设置的值

返回值

成功返回 1；如果当前没有打开的结构元素或没有选中文档，则返回 0

备注

/T 条目定义于 ISO 32000-1 §14.7.2 Table 324。它作为 PDF text string 写入结构元素字典

Title 与结构元素上的其他文本属性用途不同

/T (Title) — 用于导航和标签面板的元素说明标签。适合章节标题、表格标题和图题
/Alt（见 SetStructElemAltText）— 当元素无法呈现时，提供给辅助技术的完整文本替代说明
/ActualText（见 SetStructElemActualText）— 为提取文本可能出错的字形序列提供精确 Unicode 替代文本

PDF 查看器使用 /T 在 Tags 导航面板中标记元素。无障碍工具和修复软件把它作为文档导航的地标标题。对于标题元素（H1–H6），元素内容本身就是标题文本；/T 更适合非文本元素（Table、Figure、Form）或需要说明性标签的容器（Sect、Div）

示例

// Tag a data table with a title for navigation and accessibility tools
PDFlib.BeginTag('Table', '', '');
PDFlib.SetStructElemTitle('Table 2: Annual Revenue by Region');
// ... table rows and cells
PDFlib.EndTag;

// Tag a document section
PDFlib.BeginTag('Sect', '', '');
PDFlib.SetStructElemTitle('Chapter 3: Implementation');
// ... section content
PDFlib.EndTag;

另请参阅

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics