Partager via

Word.InsertShapeOptions interface

Paquet:
word

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 ]

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 ]