PowerPoint.ShapeGetImageOptions interface
Representa as opções disponíveis ao obter uma imagem de uma forma. A imagem é dimensionada para caber nas dimensões pretendidas. Se a largura e a altura não forem especificadas, é utilizado o tamanho verdadeiro da forma. Se apenas uma de largura ou altura for especificada, a outra será calculada para preservar a proporção. As dimensões resultantes serão automaticamente presas ao tamanho máximo suportado, se forem demasiado grandes.
Comentários
[ Conjunto de API: PowerPointApi 1.10 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/get-shape-as-image.yaml
// Gets an image of the first selected shape with all options specified:
// a fixed width, height, and explicit PNG format.
await PowerPoint.run(async (context) => {
const shapes: PowerPoint.ShapeScopedCollection = context.presentation.getSelectedShapes();
const shapeCount = shapes.getCount();
await context.sync();
if (shapeCount.value === 0) {
console.warn("No shapes are selected. Please select a shape and try again.");
return;
}
const shape: PowerPoint.Shape = shapes.getItemAt(0);
const options: PowerPoint.ShapeGetImageOptions = {
format: PowerPoint.ShapeGetImageFormatType.png,
width: 300,
height: 150,
// Both width and height are specified, so the image is scaled to fit within
// 300x150 pixels. The image may not fill both dimensions if the aspect ratios differ.
};
const imageResult: OfficeExtension.ClientResult<string> = shape.getImageAsBase64(options);
await context.sync();
displayImage(imageResult.value, "PNG, 300x150px");
});
Propriedades
| format | O formato pretendido da imagem resultante. |
| height | A altura pretendida da imagem resultante em píxeis. Este valor será automaticamente fixado ao tamanho máximo suportado, se for demasiado grande. Gera uma exceção |
| width | A largura pretendida da imagem resultante em píxeis. Este valor será automaticamente fixado ao tamanho máximo suportado, se for demasiado grande. Gera uma exceção |
Detalhes da propriedade
format
O formato pretendido da imagem resultante.
format?: PowerPoint.ShapeGetImageFormatType | "Png";Valor da propriedade
Comentários
height
A altura pretendida da imagem resultante em píxeis. Este valor será automaticamente fixado ao tamanho máximo suportado, se for demasiado grande. Gera uma exceção InvalidArgument quando definida com um número inteiro não positivo.
height?: number;Valor da propriedade
number
Comentários
width
A largura pretendida da imagem resultante em píxeis. Este valor será automaticamente fixado ao tamanho máximo suportado, se for demasiado grande. Gera uma exceção InvalidArgument quando definida com um número inteiro não positivo.
width?: number;Valor da propriedade
number