SetSpacingBefore
设置当前段落的段前间距。
如果 isBeforeAuto 参数的值为 true，则 nBefore 的任何值都将被忽略。如果未指定 isBeforeAuto 参数，则将其解释为 false。
继承自 ApiParaPr.SetSpacingBefore。
语法
expression.SetSpacingBefore(nBefore, isBeforeAuto);
expression - 表示 ApiParagraph 类的变量。
参数
| 名称 | 必需/可选 | 数据类型 | 默认值 | 描述 |
|---|---|---|---|---|
| nBefore | 必需 | twips | 当前段落段前间距的值，以磅的二十分之一（1/1440 英寸）为单位。 | |
| isBeforeAuto | 可选 | boolean | false | true 值禁用当前段落的段前间距。 |
返回值
boolean
示例
在文档中设置段落前的间距。
// How do I add extra space above a paragraph to separate it from the previous one in a document?
// Push a paragraph down from the preceding content by adjusting its top gap in a document.
let doc = Api.GetDocument();
let paragraph = doc.GetElement(0);
paragraph.AddText("This is an example of setting a space before a paragraph. ");
paragraph.AddText("The second paragraph will have an offset of one inch from the top. ");
paragraph.AddText("This is due to the fact that the second paragraph has this offset enabled.");
paragraph = Api.CreateParagraph();
paragraph.AddText("This is the second paragraph and it is one inch away from the first paragraph.");
paragraph.SetSpacingBefore(1440);
doc.Push(paragraph);