BeginTagExA

标记 PDF、可访问性

描述

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

在当前页面上打开带有显式自然语言属性的带标签 PDF 结构元素。与 BeginTag 相同，但新增 Lang 参数，该参数会写入结构元素的 /Lang 属性

对语言不同于文档默认语言的内容使用此函数（默认语言由 SetPDFUAMode 或 SetDocumentLanguage 设置），ISO 14289-1 §7.2 要求不使用文档主要语言的任何文本段均设置 /Lang 属性

标记必须保持平衡：每次 BeginTagEx 调用后都必须有匹配的 EndTag 调用。标记可以嵌套

语法

Delphi

Function DLBeginTagExA(InstanceID: Integer; TagType, AltText, ActualText, Lang: PAnsiChar): Integer;

DLL

int DLBeginTagExA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * Lang);

参数

TagTypePDF 标准结构类型：P、H1 鈥?H6、Figure、Table、TR、TH、TD、L、LI、LBody、Span、Link、Note 等（参见 ISO 32000-1 搂14.8.4）
AltText图像和其他非文本内容的替代文本（/Alt 属性），如非必需则传入空字符串
ActualText视觉形式与逻辑含义不同的内容的替换文本（/ActualText 属性）。不需要时传递空字符串
Lang此元素中内容的 BCP 47 语言标签，例如 en-US、fr-FR、zh-Hans，传递空字符串可继承文档语言，非空时会覆盖此元素及其所有后代的文档级语言

返回值

0失败（未打开文档）
1标记已成功打开

示例

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;