PowerPoint.ShapeAddOptions interface

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

Hinweise

API-Satz: PowerPointApi 1.4

Verwendet von

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 des Shapes in Punkten an. Wenn kein Wert angegeben wird, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn sie mit einem negativen Wert festgelegt wird.

left

Gibt den Abstand in Punkt von der linken Seite des Shapes zur linken Seite der Folie an. Wenn kein Wert angegeben wird, wird ein Standardwert verwendet.

top

Gibt den Abstand in Punkt vom oberen Rand des Shapes zum oberen Rand der Folie an. Wenn kein Wert angegeben wird, wird ein Standardwert verwendet.

width

Gibt die Breite des Shapes in Punkten an. Wenn kein Wert angegeben wird, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn sie mit einem negativen Wert festgelegt wird.

Details zur Eigenschaft

height

Gibt die Höhe des Shapes in Punkten an. Wenn kein Wert angegeben wird, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn sie 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 des Shapes zur linken Seite der Folie an. Wenn kein Wert angegeben wird, wird ein Standardwert verwendet.

left?: number;

Eigenschaftswert

number

Hinweise

API-Satz: PowerPointApi 1.4

top

Gibt den Abstand in Punkt vom oberen Rand des Shapes zum oberen Rand der Folie an. Wenn kein Wert angegeben wird, wird ein Standardwert verwendet.

top?: number;

Eigenschaftswert

number

Hinweise

API-Satz: PowerPointApi 1.4

width

Gibt die Breite des Shapes in Punkten an. Wenn kein Wert angegeben wird, wird ein Standardwert verwendet. Löst eine InvalidArgument Ausnahme aus, wenn sie mit einem negativen Wert festgelegt wird.

width?: number;

Eigenschaftswert

number

Hinweise

API-Satz: PowerPointApi 1.4