Compartilhar via


Word.InsertShapeOptions interface

Especifica as opções para determinar a localização e o tamanho ao inserir uma forma.

Comentários

[ Conjunto de API: WordApiDesktop 1.2 ]

Exemplos

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

Propriedades

height

Se for fornecido, especifica a altura da forma que está a ser inserida.

left

Se for fornecido, especifica a posição esquerda da forma que está a ser inserida.

top

Se for fornecido, especifica a posição superior da forma que está a ser inserida.

width

Se for fornecido, especifica a largura da forma que está a ser inserida.

Detalhes da propriedade

height

Se for fornecido, especifica a altura da forma que está a ser inserida.

height?: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApiDesktop 1.2 ]

left

Se for fornecido, especifica a posição esquerda da forma que está a ser inserida.

left?: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApiDesktop 1.2 ]

top

Se for fornecido, especifica a posição superior da forma que está a ser inserida.

top?: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApiDesktop 1.2 ]

width

Se for fornecido, especifica a largura da forma que está a ser inserida.

width?: number;

Valor da propriedade

number

Comentários

[ Conjunto de API: WordApiDesktop 1.2 ]