Compartir a través de

PowerPoint.Slide class

  • Referencia
Paquete:
powerpoint

Representa una sola diapositiva de una presentación.

Extends
OfficeExtension.ClientObject

Comentarios

[ Conjunto de API: PowerPointApi 1.2 ]

Propiedades

context

Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office.
id

Obtiene el identificador único de la diapositiva.
layout

Obtiene el diseño de la diapositiva.
shapes

Devuelve una colección de formas de la diapositiva.
slideMaster

Obtiene el SlideMaster objeto que representa el contenido predeterminado de la diapositiva.
tags

Devuelve una colección de etiquetas en la diapositiva.

Métodos

delete()

Elimina la diapositiva de la presentación. No hace nada si la diapositiva no existe.
exportAsBase64()

Exporta la diapositiva a su propio archivo de presentación, devuelto como datos codificados en base64.
getImageAsBase64(options)

Representa una imagen de la diapositiva. La imagen se escala para ajustarse a las dimensiones deseadas. Si no se especifican el ancho y el alto, se usa el tamaño verdadero de la diapositiva. Si solo se especifica uno de ancho o alto, el otro se calculará para conservar la relación de aspecto.
load(options)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.
load(propertyNames)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.
load(propertyNamesAndPaths)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.
setSelectedShapes(shapeIds)

Selecciona las formas especificadas. La selección de formas existente se reemplaza por la nueva selección.
toJSON()

Invalida el método JavaScript toJSON() para proporcionar una salida más útil cuando se pasa un objeto de API a JSON.stringify(). (JSON.stringifya su vez, llama al toJSON método del objeto que se le pasa). Mientras que el objeto PowerPoint.Slide original es un objeto de API, el toJSON método devuelve un objeto JavaScript sin formato (escrito como PowerPoint.Interfaces.SlideData) que contiene copias superficiales de las propiedades secundarias cargadas del objeto original.

Detalles de las propiedades

context

Contexto de solicitud asociado al objeto . Esto conecta el proceso del complemento al proceso de la aplicación host de Office.

context: RequestContext;

Valor de propiedad

PowerPoint.RequestContext

id

Obtiene el identificador único de la diapositiva.

readonly id: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: PowerPointApi 1.2 ]

layout

Obtiene el diseño de la diapositiva.

readonly layout: PowerPoint.SlideLayout;

Valor de propiedad

PowerPoint.SlideLayout

Comentarios

[ Conjunto de API: PowerPointApi 1.3 ]

shapes

Devuelve una colección de formas de la diapositiva.

readonly shapes: PowerPoint.ShapeCollection;

Valor de propiedad

PowerPoint.ShapeCollection

Comentarios

[ Conjunto de API: PowerPointApi 1.3 ]

slideMaster

Obtiene el SlideMaster objeto que representa el contenido predeterminado de la diapositiva.

readonly slideMaster: PowerPoint.SlideMaster;

Valor de propiedad

PowerPoint.SlideMaster

Comentarios

[ Conjunto de API: PowerPointApi 1.3 ]

tags

Devuelve una colección de etiquetas en la diapositiva.

readonly tags: PowerPoint.TagCollection;

Valor de propiedad

PowerPoint.TagCollection

Comentarios

[ Conjunto de API: PowerPointApi 1.3 ]

Detalles del método

delete()

Elimina la diapositiva de la presentación. No hace nada si la diapositiva no existe.

delete(): void;

Devoluciones

void

Comentarios

[ Conjunto de API: PowerPointApi 1.2 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/slide-management/get-set-slides.yaml

// Deletes the selected slides.
await PowerPoint.run(async (context) => {
  context.presentation.load("slides");
  await context.sync();
  const slides = context.presentation.getSelectedSlides();
  const slideCount = slides.getCount();
  slides.load("items");
  await context.sync();
  slides.items.map((slide) => {
    slide.delete();
  });
});

exportAsBase64()

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.

Exporta la diapositiva a su propio archivo de presentación, devuelto como datos codificados en base64.

exportAsBase64(): OfficeExtension.ClientResult<string>;

Devoluciones

OfficeExtension.ClientResult<string>

Comentarios

[ Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR) ]

getImageAsBase64(options)

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 una imagen de la diapositiva. La imagen se escala para ajustarse a las dimensiones deseadas. Si no se especifican el ancho y el alto, se usa el tamaño verdadero de la diapositiva. Si solo se especifica uno de ancho o alto, el otro se calculará para conservar la relación de aspecto.

getImageAsBase64(options?: PowerPoint.SlideGetImageOptions): OfficeExtension.ClientResult<string>;

Parámetros

options
PowerPoint.SlideGetImageOptions

Opcional. Opciones para especificar el tamaño deseado de la imagen de diapositiva.

Devoluciones

OfficeExtension.ClientResult<string>

Cadena base64 de la imagen de diapositiva en formato PNG.

Comentarios

[ Conjunto de API: PowerPointApi BETA (SOLO VERSIÓN PRELIMINAR) ]

load(options)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(options?: PowerPoint.Interfaces.SlideLoadOptions): PowerPoint.Slide;

Parámetros

options
PowerPoint.Interfaces.SlideLoadOptions

Proporciona opciones para las propiedades del objeto que se van a cargar.

Devoluciones

PowerPoint.Slide

load(propertyNames)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNames?: string | string[]): PowerPoint.Slide;

Parámetros

propertyNames

string | string[]

Una cadena delimitada por comas o una matriz de cadenas que especifican las propiedades que se van a cargar.

Devoluciones

PowerPoint.Slide

load(propertyNamesAndPaths)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): PowerPoint.Slide;

Parámetros

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select es una cadena delimitada por comas que especifica las propiedades que se van a cargar y propertyNamesAndPaths.expand es una cadena delimitada por comas que especifica las propiedades de navegación que se van a cargar.

Devoluciones

PowerPoint.Slide

setSelectedShapes(shapeIds)

Selecciona las formas especificadas. La selección de formas existente se reemplaza por la nueva selección.

setSelectedShapes(shapeIds: string[]): void;

Parámetros

shapeIds

string[]

Lista de identificadores de forma que se van a seleccionar en la diapositiva. Si la lista está vacía, se borra la selección.

Devoluciones

void

Comentarios

[ Conjunto de API: PowerPointApi 1.5 ]

Ejemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/shapes/get-set-shapes.yaml

// Reselects shapes that were saved previously.
await PowerPoint.run(async (context) => {
  const slide1 = context.presentation.slides.getItem(savedSlideSelection[0]);
  await context.sync();
  slide1.setSelectedShapes(savedShapeSelection);
  await context.sync();
});

...

// Selects the first two shapes on slide 1.
await PowerPoint.run(async (context) => {
  context.presentation.load("slides");
  await context.sync();
  const slide1 = context.presentation.slides.getItemAt(0);
  slide1.load("shapes");
  await context.sync();
  const shapes = slide1.shapes;
  const shape1 = shapes.getItemAt(0);
  const shape2 = shapes.getItemAt(1);
  shape1.load("id");
  shape2.load("id");
  await context.sync();
  slide1.setSelectedShapes([shape1.id, shape2.id]);
  await context.sync();
});

toJSON()

Invalida el método JavaScript toJSON() para proporcionar una salida más útil cuando se pasa un objeto de API a JSON.stringify(). (JSON.stringifya su vez, llama al toJSON método del objeto que se le pasa). Mientras que el objeto PowerPoint.Slide original es un objeto de API, el toJSON método devuelve un objeto JavaScript sin formato (escrito como PowerPoint.Interfaces.SlideData) que contiene copias superficiales de las propiedades secundarias cargadas del objeto original.

toJSON(): PowerPoint.Interfaces.SlideData;

Devoluciones

PowerPoint.Interfaces.SlideData