PowerPoint.PictureAddOptions interface
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Representa las opciones disponibles al agregar una imagen (representada por un objeto PowerPoint.Shape ).
Comentarios
Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR)
Usada por
Ejemplos
// 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();
});
Propiedades
| height | Especifica el alto, en puntos, de la imagen. Cuando no se proporciona, el valor predeterminado es 72 puntos (1 pulgada). Produce una |
| left | Especifica la distancia, en puntos, desde el lado izquierdo de la imagen hasta el lado izquierdo de la diapositiva. Cuando no se proporciona, el valor predeterminado es 0. |
| top | Especifica la distancia, en puntos, desde el borde superior de la imagen hasta el borde superior de la diapositiva. Cuando no se proporciona, el valor predeterminado es 0. |
| width | Especifica el ancho, en puntos, de la imagen. Cuando no se proporciona, el valor predeterminado es 72 puntos (1 pulgada). Produce una |
Detalles de las propiedades
height
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Especifica el alto, en puntos, de la imagen. Cuando no se proporciona, el valor predeterminado es 72 puntos (1 pulgada). Produce una InvalidArgument excepción cuando se establece con un valor negativo.
height?: number;Valor de propiedad
number
Comentarios
Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR)
left
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Especifica la distancia, en puntos, desde el lado izquierdo de la imagen hasta el lado izquierdo de la diapositiva. Cuando no se proporciona, el valor predeterminado es 0.
left?: number;Valor de propiedad
number
Comentarios
Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR)
top
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Especifica la distancia, en puntos, desde el borde superior de la imagen hasta el borde superior de la diapositiva. Cuando no se proporciona, el valor predeterminado es 0.
top?: number;Valor de propiedad
number
Comentarios
Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR)
width
Nota
Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.
Especifica el ancho, en puntos, de la imagen. Cuando no se proporciona, el valor predeterminado es 72 puntos (1 pulgada). Produce una InvalidArgument excepción cuando se establece con un valor negativo.
width?: number;Valor de propiedad
number
Comentarios
Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR)