大纲#

大纲(或“书签”)是文档的一个属性。如果不是,它代表文档的第一个大纲项。其属性反过来定义了该项的特性,并且指向“水平”或向下方向的其他大纲项。例如,通过跟随这些“指针”,可以恢复所有大纲项的完整树形结构,比如传统的目录(TOC)。

方法 / 属性

简短描述

Outline.down

下一个项目向下

Outline.next

下一个同级项目

Outline.page

页码(基于0)

Outline.title

标题

Outline.uri

进一步指定大纲目标的字符串

Outline.is_external

目标在文档外部

Outline.is_open

子大纲是否展开或折叠

Outline.dest

指向目的地详情对象

类 API

class Outline#
down#

下一个层级的轮廓项。如果该项没有子项,则为

Type:

大纲

next#

与此项目同级的下一个大纲项目。如果这是其层级中的最后一个,则为 None

Type:

大纲

page#

此书签指向的页面编号(基于0)。

Type:

整型

title#

项的标题作为字符串或

Type:

字符串

is_open#

指示器显示是否应该展开任何子大纲(True)或折叠(False)。此信息由PDF阅读器软件解释。

Type:

布尔值

is_external#

一个布尔值,指定目标是否在当前文档外部(True)。

Type:

布尔值

uri#

一个指定链接目标的字符串。该属性的含义应与属性 is_external 一起评估:

  • is_external 为真:uri 指向当前 PDF 之外的某个目标,可能是互联网资源(urihttp:// 或类似的开头),另一个文件(urifile:file:// 开头),或其他服务,如电子邮件地址(urimailto: 开头)。

  • is_external 为假时:uri 将是 None 或指向一个内部位置。在PDF文档的情况下,这应该是 #nnnn 以指示一个基于1的(!)页码 nnnn,或者一个命名的位置。其他文档类型的格式各不相同,例如在XPS文档中,页码2(基于1)为“../FixedDoc.fdoc#PG_2_LNK_1”。

Type:

字符串

dest#

链接目标详细信息对象。

Type:

linkDest


本软件按原样提供,不作任何明示或暗示的担保。该软件根据许可证分发,除非按照该许可证的条款明确授权,否则不得复制、修改或分发。有关许可信息,请参阅artifex.com或联系Artifex Software Inc.,地址:39 Mesa Street, Suite 108A, San Francisco CA 94129, United States以获取更多信息。