PowerPoint.ShapeAddOptions interface
Representa as opções disponíveis ao adicionar formas.
Comentários
[ Conjunto de API: PowerPointApi 1.4 ]
Exemplos
// 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();
});
Propriedades
| height | Especifica a altura, em pontos, da forma. Quando não for fornecido, será utilizado um valor predefinido. Lança uma exceção |
| left | Especifica a distância, em pontos, do lado esquerdo da forma para o lado esquerdo do diapositivo. Quando não for fornecido, será utilizado um valor predefinido. |
| top | Especifica a distância, em pontos, desde a margem superior da forma até à margem superior do diapositivo. Quando não for fornecido, será utilizado um valor predefinido. |
| width | Especifica a largura, em pontos, da forma. Quando não for fornecido, será utilizado um valor predefinido. Lança uma exceção |
Detalhes da propriedade
height
Especifica a altura, em pontos, da forma. Quando não for fornecido, será utilizado um valor predefinido. Lança uma exceção InvalidArgument quando definida com um valor negativo.
height?: number;Valor da propriedade
number
Comentários
left
Especifica a distância, em pontos, do lado esquerdo da forma para o lado esquerdo do diapositivo. Quando não for fornecido, será utilizado um valor predefinido.
left?: number;Valor da propriedade
number
Comentários
top
Especifica a distância, em pontos, desde a margem superior da forma até à margem superior do diapositivo. Quando não for fornecido, será utilizado um valor predefinido.
top?: number;Valor da propriedade
number
Comentários
width
Especifica a largura, em pontos, da forma. Quando não for fornecido, será utilizado um valor predefinido. Lança uma exceção InvalidArgument quando definida com um valor negativo.
width?: number;Valor da propriedade
number