BeginTag

标记 PDF, 无障碍

说明

本页介绍 PDFlibPas 中属于“标记 PDF, 无障碍”主题的 BeginTag。API 名称、参数、类名、文件名和字面量保持原样，以便和 Delphi 库及 DLL 入口点完全对应。

调用函数前请查看语法、参数和返回值。代码块保留原始形式，便于示例直接复制使用。

调用函数前请查看语法、参数和返回值。代码块保留原始形式，便于示例直接复制使用。 EndTag

语法

Delphi

Function TPDFlib.BeginTag(Const TagType, AltText, ActualText: WideString): Integer;

ActiveX

Function PDFlib::BeginTag(TagType As String, AltText As String, ActualText As String) As Long

DLL

int DLBeginTag(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText);

参数

TagTypeTagType 是 BeginTag 的参数。请使用签名中显示的类型，并提供与当前 PDF 文档、所选页面或活动资源一致的值。
AltTextAltText 是 BeginTag 的参数。请使用签名中显示的类型，并提供与当前 PDF 文档、所选页面或活动资源一致的值。
ActualTextActualText 是 BeginTag 的参数。请使用签名中显示的类型，并提供与当前 PDF 文档、所选页面或活动资源一致的值。

返回值

0此值说明 BeginTag 的调用结果。通常非零值表示成功，0 表示操作未完成。
1此值说明 BeginTag 的调用结果。通常非零值表示成功，0 表示操作未完成。

示例

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

备注

调用函数前请查看语法、参数和返回值。代码块保留原始形式，便于示例直接复制使用。 BeginArtifact, EndArtifact

使用此 API 时，请注意 PDF/A 限制、所需最低 PDF 版本、外部资源以及当前选定的文档状态。 SetPDFUAMode