PowerPoint.ShapeAddOptions interface

Paquet:

powerpoint

Représente les options disponibles lors de l’ajout de formes.

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

Exemples

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

Propriétés

height	Spécifie la hauteur, en points, de la forme. Lorsqu’elle n’est pas fournie, une valeur par défaut est utilisée. Lève une exception lorsqu’elle InvalidArgument est définie avec une valeur négative.
left	Spécifie la distance, en points, entre le côté gauche de la forme et le côté gauche de la diapositive. Lorsqu’elle n’est pas fournie, une valeur par défaut est utilisée.
top	Spécifie la distance, en points, entre le bord supérieur de la forme et le bord supérieur de la diapositive. Lorsqu’elle n’est pas fournie, une valeur par défaut est utilisée.
width	Spécifie la largeur, en points, de la forme. Lorsqu’elle n’est pas fournie, une valeur par défaut est utilisée. Lève une exception lorsqu’elle InvalidArgument est définie avec une valeur négative.

Détails de la propriété

height

Spécifie la hauteur, en points, de la forme. Lorsqu’elle n’est pas fournie, une valeur par défaut est utilisée. Lève une exception lorsqu’elle InvalidArgument est définie avec une valeur négative.

height?: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

left

Spécifie la distance, en points, entre le côté gauche de la forme et le côté gauche de la diapositive. Lorsqu’elle n’est pas fournie, une valeur par défaut est utilisée.

left?: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

top

Spécifie la distance, en points, entre le bord supérieur de la forme et le bord supérieur de la diapositive. Lorsqu’elle n’est pas fournie, une valeur par défaut est utilisée.

top?: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

width

Spécifie la largeur, en points, de la forme. Lorsqu’elle n’est pas fournie, une valeur par défaut est utilisée. Lève une exception lorsqu’elle InvalidArgument est définie avec une valeur négative.

width?: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]