PowerPoint.PictureAddOptions interface
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Representa as opções disponíveis ao adicionar uma imagem (representada por um objeto PowerPoint.Shape ).
Comentários
Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO)
Usada por
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/preview-apis/add-picture.yaml
// Insert a picture on the current slide.
await PowerPoint.run(async (context) => {
const slide: PowerPoint.Slide = context.presentation.getSelectedSlides().getItemAt(0);
// Use PictureAddOptions to control the position and dimensions (in points).
const options: PowerPoint.PictureAddOptions = {
left: 100,
top: 100,
width: 250,
height: 180,
};
const picture: PowerPoint.Shape = slide.shapes.addPicture(getSampleImageBase64(), options);
picture.name = "SamplePicture";
// Set accessibility properties on the inserted picture.
picture.altTextTitle = "Sample image";
picture.altTextDescription = "A cartoon dog image used as a sample picture in this add-in.";
await context.sync();
});
Propriedades
| height | Especifica a altura, em pontos, da imagem. Quando não for fornecido, o valor predefinido é 72 pontos (1 polegada). Lança uma exceção |
| left | Especifica a distância, em pontos, do lado esquerdo da imagem para o lado esquerdo do diapositivo. Quando não for fornecido, o valor predefinido é 0. |
| top | Especifica a distância, em pontos, desde a margem superior da imagem até à margem superior do diapositivo. Quando não for fornecido, o valor predefinido é 0. |
| width | Especifica a largura, em pontos, da imagem. Quando não for fornecido, o valor predefinido é 72 pontos (1 polegada). Lança uma exceção |
Detalhes da propriedade
height
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Especifica a altura, em pontos, da imagem. Quando não for fornecido, o valor predefinido é 72 pontos (1 polegada). Lança uma exceção InvalidArgument quando definida com um valor negativo.
height?: number;Valor da propriedade
number
Comentários
Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO)
left
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Especifica a distância, em pontos, do lado esquerdo da imagem para o lado esquerdo do diapositivo. Quando não for fornecido, o valor predefinido é 0.
left?: number;Valor da propriedade
number
Comentários
Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO)
top
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Especifica a distância, em pontos, desde a margem superior da imagem até à margem superior do diapositivo. Quando não for fornecido, o valor predefinido é 0.
top?: number;Valor da propriedade
number
Comentários
Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO)
width
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Especifica a largura, em pontos, da imagem. Quando não for fornecido, o valor predefinido é 72 pontos (1 polegada). Lança uma exceção InvalidArgument quando definida com um valor negativo.
width?: number;Valor da propriedade
number
Comentários
Conjunto de API: PowerPointApi BETA (APENAS PRÉ-VISUALIZAÇÃO)