AddPageLabels
页面属性
描述
向所选文档添加一组页面标签。文档中必须存在从第 1 页开始的范围,页面标签才能正确显示。页面标签是 PDF 1.3 目录功能;除非明确锁定保存版本,否则在较低版本文档上调用此方法会将有效 PDF 版本提升至 1.3
当已加载文档将页面标签存储在带子节点的数字树中时,已有的标签范围会被保留;插入或替换的范围在文档保存并重新加载后仍然有效
语法
Delphi
Function TPDFlib.AddPageLabels(Start, Style, Offset: Integer; Const Prefix: WideString): Integer;
ActiveX
Function PDFlib::AddPageLabels(Start As Long, Style As Long, Offset As Long, Prefix As String) As Long
DLL
int DLAddPageLabels(int InstanceID, int Start, int Style, int Offset, const wchar_t * Prefix);
参数
| Start | 页码标签范围的起始页面 |
|---|---|
| Style | 0 = 无编号 1 = 十进制阿拉伯数字 2 = 大写罗马数字 3 = 小写罗马数字 4 = 大写字母(前 26 页为 A 至 Z,接下来的 26 页为 AA 至 ZZ,依此类推)5 = 小写字母(前 26 页为 a 至 z,接下来的 26 页为 aa 至 zz,依此类推) |
| Offset | 范围内第一个页面标签数字部分的值。后续值从此值开始连续编号,该值必须大于或等于 1 |
| Prefix | 此范围内页标签的前缀 |
返回值
| 0 | Style 参数超出范围 |
|---|---|
| 1 | 已成功添加页面标签范围 |