跳到主要内容

SetSpacingBefore

设置当前段落的段前间距。如果 isBeforeAuto 参数的值为 true,则 nBefore 的任何值都将被忽略。如果未指定 isBeforeAuto 参数,则 将其解释为 false。

语法

expression.SetSpacingBefore(nBefore, isBeforeAuto);

expression - 表示 ApiParaPr 类的变量。

参数

名称必需/可选数据类型默认值描述
nBefore必需twips当前段落段前间距的值,以磅的二十分之一(1/1440 英寸)为单位。
isBeforeAuto可选booleanfalsetrue 值禁用当前段落的段前间距。

返回值

boolean

示例

此示例设置当前段落的段前间距。

// How to add the spacing before the paragraphs using points.

// Get a paragraph from the shape's content then add a text specifying the spacing before a custom text.

let worksheet = Api.GetActiveSheet();
let fill = Api.CreateSolidFill(Api.RGB(255, 111, 61));
let stroke = Api.CreateStroke(0, Api.CreateNoFill());
let shape = worksheet.AddShape("flowChartOnlineStorage", 120 * 36000, 70 * 36000, fill, stroke, 0, 2 * 36000, 0, 3 * 36000);
let content = shape.GetContent();
let paragraph = content.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();
let paraPr = paragraph.GetParaPr();
paraPr.SetSpacingBefore(1440);
paragraph.AddText("This is the second paragraph and it is one inch away from the first paragraph.");
content.Push(paragraph);