PowerPoint.ShapeGetImageOptions interface
Representa as opções disponíveis ao obter uma imagem de uma forma. A imagem é dimensionada para caber nas dimensões desejadas. Se a largura e a altura não forem especificadas, o tamanho real da forma será usado. Se apenas uma largura ou altura for especificada, a outra será calculada para preservar a taxa de proporção. As dimensões resultantes serão fixadas automaticamente no tamanho máximo com suporte se forem muito grandes.
Comentários
Conjunto de APIs: PowerPointApi 1.10
Usada por
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 desejado da imagem resultante. |
| height | A altura desejada da imagem resultante em pixels. Esse valor será fixado automaticamente ao tamanho máximo com suporte se for muito grande. Lança uma |
| width | A largura desejada da imagem resultante em pixels. Esse valor será fixado automaticamente ao tamanho máximo com suporte se for muito grande. Lança uma |
Detalhes da propriedade
format
O formato desejado da imagem resultante.
format?: PowerPoint.ShapeGetImageFormatType | "Png";Valor da propriedade
Comentários
height
A altura desejada da imagem resultante em pixels. Esse valor será fixado automaticamente ao tamanho máximo com suporte se for muito grande. Lança uma InvalidArgument exceção quando definido com um inteiro não positivo.
height?: number;Valor da propriedade
number
Comentários
width
A largura desejada da imagem resultante em pixels. Esse valor será fixado automaticamente ao tamanho máximo com suporte se for muito grande. Lança uma InvalidArgument exceção quando definido com um inteiro não positivo.
width?: number;Valor da propriedade
number