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 | 返回此 Shape的 PowerPoint.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 | 指定 中的文本 TextRange 是否设置为粗体。 |
| color | 指定文本颜色 (的 HTML 颜色代码表示形式,例如,“#FF0000”表示红色) 。 | |
| italic | 指定 中的文本 TextRange 是否设置为斜体。 |
|
| 名称 | 指定字体名称 (例如“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 | 表示文本范围的纯文本内容。 |