PowerPoint JavaScript API 1.4 中的新增功能
PowerPointApi 1.4 添加了对形状管理的额外支持。
第一个表提供了 API 的简明摘要，而后续表提供了详细列表。
| 功能区域 | 说明 | 相关对象 |
|---|---|---|
| 形状管理 | 添加了对添加、移动、调整大小、格式化和删除形状的支持。 |
ShapeFill ShapeFont ShapeLineFormat |
API 列表
下表列出了 PowerPoint JavaScript API 要求集 1.4。 有关所有 PowerPoint JavaScript API 的完整列表， (包括预览 API 和以前发布的 API) ，请参阅 所有 PowerPoint JavaScript API。
| 类 | 域 | 说明 |
|---|---|---|
| BulletFormat | visible | 指定段落中的项目符号是否可见。 |
| ParagraphFormat | bulletFormat | 表示段落的项目符号格式。 |
| horizontalAlignment | 表示段落的水平对齐方式。 | |
| Shape | fill | 返回此形状的填充格式。 |
| height | 指定形状的高度（以磅为单位）。 | |
| left | 从形状左侧到幻灯片左侧的距离（以磅为单位）。 | |
| lineFormat | 返回此形状的线条格式。 | |
| 名称 | 指定此形状的名称。 | |
| textFrame | 返回此形状的文本框对象。 | |
| top | 从形状的上边缘到幻灯片上边缘的距离（以磅为单位）。 | |
| type | 返回此形状的类型。 | |
| width | 指定形状的宽度（以磅为单位）。 | |
| ShapeAddOptions | height | 指定形状的高度（以磅为单位）。 |
| left | 指定从形状左侧到幻灯片左侧的距离（以磅为单位）。 | |
| top | 指定从形状上边缘到幻灯片上边缘的距离（以磅为单位）。 | |
| width | 指定形状的宽度（以磅为单位）。 | |
| ShapeCollection | addGeometricShape (geometricShapeType： PowerPoint.GeometricShapeType， options？： PowerPoint.ShapeAddOptions) | 向幻灯片添加几何形状。 |
| addLine (connectorType？： PowerPoint.ConnectorType， options？： PowerPoint.ShapeAddOptions) | 向幻灯片添加一行。 | |
| addTextBox (text： string， options？： PowerPoint.ShapeAddOptions) | 向幻灯片添加一个文本框，其中提供的文本作为内容。 | |
| ShapeFill | clear() | 清除此形状的填充格式。 |
| foregroundColor | 以 HTML 颜色格式表示形状填充前景色，格式 #RRGGBB (例如“FFA500”) 或命名 HTML 颜色 (例如“橙色”) 。 | |
| setSolidColor(color: string) | 将形状的填充格式设置为统一颜色。 | |
| transparency | 将填充的透明度百分比指定为从 0.0 (不透明) 到 1.0 (清除) 的值。 | |
| type | 返回形状的填充类型。 | |
| ShapeFont | bold | 指定字体的粗体状态。 |
| color | 指定文本颜色 (的 HTML 颜色代码表示形式，例如，“#FF0000”表示红色) 。 | |
| italic | 指定字体的斜体状态。 | |
| 名称 | 指定字体名称 (例如“Calibri”) 。 | |
| size | 指定字体大小（以磅为单位）， (例如 11) 。 | |
| underline | 指定应用于字体的下划线类型。 | |
| ShapeLineFormat | color | 表示 HTML 颜色格式的线条颜色，格式 #RRGGBB (例如“FFA500”) 或命名的 HTML 颜色 (例如“orange”) 。 |
| dashStyle | 表示线条的短划线样式。 | |
| style | 表示形状的线条样式。 | |
| transparency | 将行的透明度百分比指定为从 0.0 (不透明) 到 1.0 (清除) 的值。 | |
| visible | 指定形状元素的线条格式是否可见。 | |
| weight | 表示线条的粗细（以磅为单位）。 | |
| TextFrame | autoSizeSetting | 文本框的自动调整大小设置。 |
| bottomMargin | 表示文本框的下边距（以磅为单位）。 | |
| deleteText() | 删除文本框中的所有文本。 | |
| hasText | 指定文本框是否包含文本。 | |
| leftMargin | 表示文本框的左边距（以磅为单位）。 | |
| rightMargin | 表示文本框的右边距（以磅为单位）。 | |
| textRange | 表示附加到文本框中形状上的文本，以及用于操作文本的属性和方法。 | |
| topMargin | 表示文本框的上边距（以磅为单位）。 | |
| verticalAlignment | 表示文本框的垂直对齐方式。 | |
| wordWrap | 确定是否自动换行以适合形状内的文本。 | |
| TextRange | font | 返回一个 ShapeFont 对象，该对象代表文本区域的字体属性。 |
| getSubstring(start: number, length?: number) | 返回 TextRange 给定区域中子字符串的 对象。 |
|
| paragraphFormat | 表示文本范围的段落格式。 | |
| text | 表示文本范围的纯文本内容。 |