SetTabs
指定一系列自定义制表位,用于当前段落中的所有制表符。
- 警告:aPos 数组和 aVal 数组的长度必须相等。
语法
expression.SetTabs(aPos, aVal);
expression - 表示 ApiParaPr 类的变量。
参数
| 名称 | 必需/可选 | 数据类型 | 默认值 | 描述 |
|---|---|---|---|---|
| aPos | 必需 | twips[] | 相对于当前页面边距的自定义制表位位置数组,以二十分之一磅(1/1440 英寸)为单位。 | |
| aVal | 必需 | TabJc[] | 自定义制表位样式数组,用于确定制表位的行为以及在当前自定义制表位处输入的文本所应用的对齐方式。 |
返回值
boolean
示例
在电子表格中段落内的特定位置放置自定义制表位。
// How do I align text columns using tabs at precise distances in a spreadsheet?
// Define left, center, and right tab stops so text snaps into tidy columns when a tab character is inserted in a spreadsheet.
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", 150 * 36000, 70 * 36000, fill, stroke, 0, 2 * 36000, 0, 3 * 36000);
let content = shape.GetContent();
let paragraph = content.GetElement(0);
let paraPr = paragraph.GetParaPr();
paraPr.SetTabs([1440, 2880, 4320], ["left", "center", "right"]);
paragraph.AddTabStop();
paragraph.AddText("Custom tab - 1 inch left");
paragraph.AddLineBreak();
paragraph.AddTabStop();
paragraph.AddTabStop();
paragraph.AddText("Custom tab - 2 inches center");
paragraph.AddLineBreak();
paragraph.AddTabStop();
paragraph.AddTabStop();
paragraph.AddTabStop();
paragraph.AddText("Custom tab - 3 inches right");