跳到主要内容

SetOutlineLvl

设置指定属性的大纲级别。

继承自 ApiParaPr.SetOutlineLvl。

语法​

expression.SetOutlineLvl(lvl);

expression - 表示 ApiParagraph 类的变量。

参数​

名称必需/可选数据类型默认值描述
lvl可选Number | null | undefined大纲级别。可能的值:1-9。要取消大纲级别,请不带参数使用此方法。

返回值​

boolean

示例​

在文档中为段落分配大纲级别以构建文档层次结构。

// How do I mark a paragraph as a heading level for the document outline in a document?

// Control which paragraphs appear as headings in the navigation pane of a document.

const doc = Api.GetDocument();
const firstParagraph = doc.GetElement(0);
firstParagraph.AddText('Outline level of this paragraph is ' + firstParagraph.GetOutlineLvl() + '.');

for (let levelIndex = 0; levelIndex < 9; levelIndex++) {
const paragraph = Api.CreateParagraph();
paragraph.SetOutlineLvl(levelIndex);

const level = paragraph.GetOutlineLvl() + 1;
paragraph.AddText('This is a paragraph with outline level ' + level + '.');
doc.Push(paragraph);
}