PowerPoint.ShapeAddOptions interface

表示添加形状时可用的选项。

注解

[ API 集:PowerPointApi 1.4 ]

示例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/shapes.yaml

// This function gets the collection of shapes on the first slide,
// and adds a hexagon shape to the collection, while specifying its
// location and size. Then it names the shape.
await PowerPoint.run(async (context) => {
  const shapes: PowerPoint.ShapeCollection = context.presentation.slides.getItemAt(0).shapes;
  const shapeOptions: PowerPoint.ShapeAddOptions = {
    left: 100,
    top: 100,
    height: 150,
    width: 150
  };
  const hexagon: PowerPoint.Shape = shapes.addGeometricShape(PowerPoint.GeometricShapeType.hexagon, shapeOptions);
  hexagon.name = "Hexagon";

  await context.sync();
});

属性

height

指定形状的高度(以磅为单位)。 如果未提供,将使用默认值。 InvalidArgument使用负值设置时引发异常。

left

指定从形状左侧到幻灯片左侧的距离(以磅为单位)。 如果未提供,将使用默认值。

top

指定从形状上边缘到幻灯片上边缘的距离(以磅为单位)。 如果未提供,将使用默认值。

width

指定形状的宽度(以磅为单位)。 如果未提供,将使用默认值。 InvalidArgument使用负值设置时引发异常。

属性详细信息

height

指定形状的高度(以磅为单位)。 如果未提供,将使用默认值。 InvalidArgument使用负值设置时引发异常。

height?: number;

属性值

number

注解

[ API 集:PowerPointApi 1.4 ]

left

指定从形状左侧到幻灯片左侧的距离(以磅为单位)。 如果未提供,将使用默认值。

left?: number;

属性值

number

注解

[ API 集:PowerPointApi 1.4 ]

top

指定从形状上边缘到幻灯片上边缘的距离(以磅为单位)。 如果未提供,将使用默认值。

top?: number;

属性值

number

注解

[ API 集:PowerPointApi 1.4 ]

width

指定形状的宽度(以磅为单位)。 如果未提供,将使用默认值。 InvalidArgument使用负值设置时引发异常。

width?: number;

属性值

number

注解

[ API 集:PowerPointApi 1.4 ]