Freigeben über


PowerPoint.ShapeAddOptions interface

Stellt die verfügbaren Optionen beim Hinzufügen von Formen dar.

Hinweise

[ API-Satz: PowerPointApi 1.4 ]

Beispiele

// 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();
});

Eigenschaften

height

Gibt die Höhe der Form in Punkt an. Wenn keine Angabe erfolgt, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

left

Gibt den Abstand in Punkt von der linken Seite der Form zur linken Seite der Folie an. Wenn keine Angabe erfolgt, wird ein Standardwert verwendet.

top

Gibt den Abstand vom oberen Rand der Form bis zum oberen Rand der Folie in Punkt an. Wenn keine Angabe erfolgt, wird ein Standardwert verwendet.

width

Gibt die Breite der Form in Punkt an. Wenn keine Angabe erfolgt, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

Details zur Eigenschaft

height

Gibt die Höhe der Form in Punkt an. Wenn keine Angabe erfolgt, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

height?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.4 ]

left

Gibt den Abstand in Punkt von der linken Seite der Form zur linken Seite der Folie an. Wenn keine Angabe erfolgt, wird ein Standardwert verwendet.

left?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.4 ]

top

Gibt den Abstand vom oberen Rand der Form bis zum oberen Rand der Folie in Punkt an. Wenn keine Angabe erfolgt, wird ein Standardwert verwendet.

top?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.4 ]

width

Gibt die Breite der Form in Punkt an. Wenn keine Angabe erfolgt, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

width?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.4 ]