Word.InsertShapeOptions interface

Spécifie les options permettant de déterminer l’emplacement et la taille lors de l’insertion d’une forme.

Remarques

Ensemble d’API : WordApiDesktop 1.2

Utilisateur

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/45-shapes/manage-shapes-text-boxes.yaml

await Word.run(async (context) => {
  // Inserts a text box at the beginning of the selection.
  const range: Word.Range = context.document.getSelection();
  const insertShapeOptions: Word.InsertShapeOptions = {
    top: 0,
    left: 0,
    height: 100,
    width: 100
  };

  const newTextBox: Word.Shape = range.insertTextBox("placeholder text", insertShapeOptions);
  await context.sync();

  console.log("Inserted a text box at the beginning of the current selection.");
});

Propriétés

height

Si elle est fournie, spécifie la hauteur de la forme insérée.

left

Si elle est fournie, spécifie la position gauche de la forme insérée.

top

Si elle est fournie, spécifie la position supérieure de la forme insérée.

width

Si elle est fournie, spécifie la largeur de la forme insérée.

Détails de la propriété

height

Si elle est fournie, spécifie la hauteur de la forme insérée.

height?: number;

Valeur de propriété

number

Remarques

Ensemble d’API : WordApiDesktop 1.2

left

Si elle est fournie, spécifie la position gauche de la forme insérée.

left?: number;

Valeur de propriété

number

Remarques

Ensemble d’API : WordApiDesktop 1.2

top

Si elle est fournie, spécifie la position supérieure de la forme insérée.

top?: number;

Valeur de propriété

number

Remarques

Ensemble d’API : WordApiDesktop 1.2

width

Si elle est fournie, spécifie la largeur de la forme insérée.

width?: number;

Valeur de propriété

number

Remarques

Ensemble d’API : WordApiDesktop 1.2