Class Image

Imagen

Un PageElement que representa una imagen.

Métodos

MétodoTipo de datos que se muestraDescripción breve
alignOnPage(alignmentPosition)ImageAlinea el elemento con la posición especificada en la página.
bringForward()ImageMueve el elemento de página hacia adelante en la página un elemento.
bringToFront()ImageMueve el elemento de página al frente de la página.
duplicate()PageElementDuplica el elemento de página.
getAs(contentType)BlobMuestra los datos de este objeto como un BLOB convertido al tipo de contenido especificado.
getBlob()BlobMuestra los datos dentro de esta imagen como un BLOB.
getBorder()BorderMuestra el Border de la imagen.
getConnectionSites()ConnectionSite[]Muestra la lista de ConnectionSite en el elemento de la página, o una lista vacía si el elemento de la página no tiene ningún sitio de conexión.
getContentUrl()StringObtiene una URL a la imagen.
getDescription()StringMuestra la descripción de texto alternativo del elemento de página.
getHeight()NumberObtiene la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando el elemento no tiene rotación.
getInherentHeight()NumberMuestra la altura inherente del elemento en puntos.
getInherentWidth()NumberMuestra el ancho inherente del elemento en puntos.
getLeft()NumberMuestra la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la página, cuando el elemento no tiene rotación.
getLink()LinkMuestra Link o null si no hay un vínculo.
getObjectId()StringMuestra el ID único de este objeto.
getPageElementType()PageElementTypeMuestra el tipo de elemento de página, representado como una enumeración PageElementType.
getParentGroup()GroupMuestra el grupo al que pertenece este elemento de la página, o null si el elemento no está en un grupo.
getParentPage()PageMuestra la página en la que se encuentra este elemento.
getParentPlaceholder()PageElementMuestra el elemento de página principal del marcador de posición.
getPlaceholderIndex()IntegerMuestra el índice de la imagen del marcador de posición.
getPlaceholderType()PlaceholderTypeMuestra el tipo de marcador de posición de la imagen o PlaceholderType.NONE si la forma no es un marcador de posición.
getRotation()NumberMuestra el ángulo de rotación del elemento en sentido horario alrededor del centro en grados, donde cero grados significa que no hay rotación.
getSourceUrl()StringObtiene la URL de origen de la imagen, si está disponible.
getTitle()StringMuestra el título de texto alternativo del elemento de la página.
getTop()NumberObtiene la posición vertical del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.
getTransform()AffineTransformMuestra la transformación del elemento de la página.
getWidth()NumberMuestra el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando el elemento no tiene rotación.
preconcatenateTransform(transform)ImageConcatena la transformación proporcionada a la transformación existente del elemento de la página.
remove()voidQuita el elemento de la página.
removeLink()voidQuita un Link.
replace(blobSource)ImageReemplaza esta imagen por una que describe un objeto BlobSource.
replace(blobSource, crop)ImageReemplaza esta imagen por una que describe un objeto Image. De manera opcional, puede recortar la imagen para que se ajuste.
replace(imageUrl)ImageReemplaza esta imagen por otra que se descargó de la URL proporcionada.
replace(imageUrl, crop)ImageReemplaza esta imagen por otra que se descargó de la URL proporcionada y, de manera opcional, recorta la imagen para que se ajuste.
scaleHeight(ratio)ImageAjusta la altura del elemento según la proporción especificada.
scaleWidth(ratio)ImageAjusta el ancho del elemento según la proporción especificada.
select()voidSelecciona solo el PageElement en la presentación activa y quita cualquier selección anterior.
select(replace)voidSelecciona el PageElement en la presentación activa.
sendBackward()ImageEnvía el elemento de página hacia atrás en la página por un elemento.
sendToBack()ImageEnvía el elemento de página al final de la página.
setDescription(description)ImageEstablece la descripción del texto alternativo del elemento de página.
setHeight(height)ImageEstablece la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando el elemento no tiene rotación.
setLeft(left)ImageEstablece la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la página, cuando el elemento no tiene rotación.
setLinkSlide(slideIndex)LinkEstablece un Link para la Slide determinada mediante el índice basado en cero de la diapositiva.
setLinkSlide(slide)LinkEstablece un Link en la Slide determinada. El vínculo se establece en el ID de la diapositiva determinada.
setLinkSlide(slidePosition)LinkEstablece un Link para la Slide determinada usando la posición relativa de la diapositiva.
setLinkUrl(url)LinkEstablece un Link para la string de URL no vacía especificada.
setRotation(angle)ImageEstablece el ángulo de rotación del elemento en sentido horario alrededor del centro en grados.
setTitle(title)ImageEstablece el título del texto alternativo del elemento de la página.
setTop(top)ImageEstablece la posición vertical del elemento en puntos, medida desde la esquina superior izquierda de la página, cuando el elemento no tiene rotación.
setTransform(transform)ImageEstablece la transformación del elemento de la página con la transformación proporcionada.
setWidth(width)ImageEstablece el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando el elemento no tiene rotación.

Documentación detallada

alignOnPage(alignmentPosition)

Alinea el elemento con la posición especificada en la página.

Parámetros

NombreTipoDescripción
alignmentPositionAlignmentPositionEs la posición con la que se alinea este elemento de la página.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

bringForward()

Mueve el elemento de página hacia adelante en la página un elemento.

El elemento de la página no debe estar en un grupo.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

bringToFront()

Mueve el elemento de página al frente de la página.

El elemento de la página no debe estar en un grupo.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

duplicate()

Duplica el elemento de página.

El elemento de página duplicado se coloca en la misma página en la misma posición que el original.

Volver

PageElement: Es el nuevo duplicado de este elemento de página.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getAs(contentType)

Muestra los datos de este objeto como un BLOB convertido al tipo de contenido especificado. Este método agrega la extensión adecuada al nombre del archivo, por ejemplo, "myfile.pdf". Sin embargo, se supone que la parte del nombre de archivo que sigue al último punto (si existe) es una extensión existente que debe reemplazarse. En consecuencia, “ShoppingList.12.25.2014” se convierte en “ShoppingList.12.25.pdf”.

Si deseas ver las cuotas diarias de conversiones, consulta Cuotas para servicios de Google. Los dominios de Google Workspace creados recientemente pueden estar sujetos a cuotas más estrictas de forma temporal.

Parámetros

NombreTipoDescripción
contentTypeStringEl tipo de MIME al que deseas convertir. Para la mayoría de los BLOB, 'application/pdf' es la única opción válida. Para las imágenes en formato BMP, GIF, JPEG o PNG, también son válidas cualquiera de las siguientes opciones: 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'.

Volver

Blob: los datos como un BLOB

getBlob()

Muestra los datos dentro de esta imagen como un BLOB.

Volver

Blob: los datos de imagen como un BLOB.

getBorder()

Muestra el Border de la imagen.

Volver

Border: El borde de la imagen.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getConnectionSites()

Muestra la lista de ConnectionSite en el elemento de la página, o una lista vacía si el elemento de la página no tiene ningún sitio de conexión.

Volver

ConnectionSite[]: Es la lista de sitios de conexión, que puede estar vacía si este elemento no tiene sitios de conexión.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getContentUrl()

Obtiene una URL a la imagen.

Esta URL está etiquetada con la cuenta del solicitante, por lo que cualquier persona con la URL accede efectivamente a la imagen como el solicitante original. Es posible que se pierda el acceso a la imagen si cambia la configuración de uso compartido de la presentación. La URL que se muestra vence después de un período corto.

Volver

String

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getDescription()

Muestra la descripción de texto alternativo del elemento de página. La descripción se combina con el título para mostrar y leer el texto alternativo.

Volver

String: Es la descripción de texto alternativo del elemento de la página.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getHeight()

Obtiene la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando el elemento no tiene rotación.

Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Volver

Number: Corresponde a la altura inherente del elemento de página en puntos, o null si el elemento de página no tiene una altura.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getInherentHeight()

Muestra la altura inherente del elemento en puntos.

La transformación del elemento de página está relacionada con su tamaño inherente. Usa el tamaño inherente junto con la transformación del elemento para determinar la apariencia visual final del elemento.

Volver

Number: Corresponde a la altura inherente del elemento de página en puntos, o null si el elemento de página no tiene una altura.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getInherentWidth()

Muestra el ancho inherente del elemento en puntos.

La transformación del elemento de página está relacionada con su tamaño inherente. Usa el tamaño inherente junto con la transformación del elemento para determinar la apariencia visual final del elemento.

Volver

Number: Es el ancho inherente del elemento de página en puntos, o null si el elemento de página no tiene un ancho.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLeft()

Muestra la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la página, cuando el elemento no tiene rotación.

Volver

Number: Es la posición horizonal de este elemento en puntos desde la esquina superior izquierda de la página.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Muestra Link o null si no hay un vínculo. 

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Volver

Link

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getObjectId()

Muestra el ID único de este objeto. Los ID de objeto que usan las páginas y los elementos de página comparten el mismo espacio de nombres.

Volver

String: el ID único de este objeto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElementType()

Muestra el tipo de elemento de página, representado como una enumeración PageElementType.

Volver

PageElementType: Es el tipo de elemento de la página.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParentGroup()

Muestra el grupo al que pertenece este elemento de la página, o null si el elemento no está en un grupo.

Volver

Group: Es el grupo al que pertenece este elemento de la página, o null.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParentPage()

Muestra la página en la que se encuentra este elemento.

Volver

Page: Es la página en la que reside este elemento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getParentPlaceholder()

Muestra el elemento de página principal del marcador de posición. Muestra null si la imagen no es un marcador de posición o no tiene un superior.

Volver

PageElement: Es el elemento de la página principal de este marcador de posición de imagen, o null si la imagen no es un marcador de posición o no tiene un elemento superior.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholderIndex()

Muestra el índice de la imagen del marcador de posición. Si dos o más imágenes de marcador de posición en la misma página son del mismo tipo, cada una tiene un valor de índice único. Muestra null si la imagen no es un marcador de posición.

Volver

Integer: el índice de marcador de posición de esta imagen, o null si la imagen no es un marcador de posición.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholderType()

Muestra el tipo de marcador de posición de la imagen o PlaceholderType.NONE si la forma no es un marcador de posición.

Volver

PlaceholderType: Es el tipo de marcador de posición de esta imagen.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getRotation()

Muestra el ángulo de rotación del elemento en sentido horario alrededor del centro en grados, donde cero grados significa que no hay rotación.

Volver

Number: Es el ángulo de rotación en grados entre 0 (inclusive) y 360 (exclusivo).

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSourceUrl()

Obtiene la URL de origen de la imagen, si está disponible.

Cuando se inserta una imagen por URL, se muestra la URL proporcionada durante la inserción de imágenes.

Volver

String: Es la URL de la imagen o null si la imagen no tiene una URL de origen.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTitle()

Muestra el título de texto alternativo del elemento de la página. El título se combina con la descripción para mostrar y leer el texto alternativo.

Volver

String: Es el título de texto alternativo del elemento de página.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTop()

Obtiene la posición vertical del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.

Volver

Number: Es la posición vertical de este elemento en puntos, desde la esquina superior izquierda de la página.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTransform()

Muestra la transformación del elemento de la página.

La apariencia visual del elemento de la página está determinada por su transformación absoluta. Para calcular la transformación absoluta, concatena la transformación de un elemento de página con las transformaciones de todos sus grupos superiores. Si el elemento de la página no está en un grupo, su transformación absoluta es la misma que el valor en este campo.

Volver

AffineTransform: es la transformación del elemento de la página.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getWidth()

Muestra el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando el elemento no tiene rotación.

Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Volver

Number: Es el ancho inherente del elemento de página en puntos, o null si el elemento de página no tiene un ancho.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

preconcatenateTransform(transform)

Concatena la transformación proporcionada a la transformación existente del elemento de la página. 

newTransform = argument * existingTransform

Por ejemplo, para mover un elemento de página 36 puntos hacia la izquierda, haz lo siguiente: 

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

También puedes reemplazar la transformación del elemento de la página por setTransform(transform).

Parámetros

NombreTipoDescripción
transformAffineTransformLa transformación que se preubicará en la transformación de este elemento de la página.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

remove()

Quita el elemento de la página.

Si, después de una operación de eliminación, un objeto Group contiene solo uno o ningún elemento de la página, también se quita el grupo.

Si se quita un marcador de posición PageElement en una instancia principal o un diseño, también se quitan los marcadores de posición heredados heredados.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Quita un Link. 

shape.removeLink();

replace(blobSource)

Reemplaza esta imagen por una que describe un objeto BlobSource.

Al insertar la imagen, se recupera de la BlobSource una vez y se almacena una copia para mostrar dentro de la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no deben superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

A fin de mantener la relación de aspecto de la imagen, esta se ajusta y se centra con respecto al tamaño de la imagen existente. 

var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
image.replace(driveImage);

Parámetros

NombreTipoDescripción
blobSourceBlobSourceLos datos de la imagen.

Volver

Image: Este Image después del reemplazo

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replace(blobSource, crop)

Reemplaza esta imagen por una que describe un objeto Image. De manera opcional, puede recortar la imagen para que se ajuste.

Al insertar la imagen, se recupera de la BlobSource una vez y se almacena una copia para mostrar dentro de la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no deben superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF. 

var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the drive image.
image.replace(driveImage, true);

Parámetros

NombreTipoDescripción
blobSourceBlobSourceLos datos de la imagen.
cropBooleanSi el valor es true, se recorta la imagen para adaptarla al tamaño existente. De lo contrario, la imagen se escala y se centra.

Volver

Image: Este Image después del reemplazo

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replace(imageUrl)

Reemplaza esta imagen por otra que se descargó de la URL proporcionada.

Al insertar la imagen, se recupera de la URL una vez y se almacena una copia para mostrar en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no deben superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

La URL proporcionada debe ser de acceso público y no debe superar los 2 KB. La URL en sí se guarda con la imagen y se expone mediante getSourceUrl().

A fin de mantener la relación de aspecto de la imagen, esta se ajusta y se centra con respecto al tamaño de la imagen existente.

Parámetros

NombreTipoDescripción
imageUrlStringLa URL desde la que se descargará la imagen.

Volver

Image: Este Image después del reemplazo

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replace(imageUrl, crop)

Reemplaza esta imagen por otra que se descargó de la URL proporcionada y, de manera opcional, recorta la imagen para que se ajuste.

Al insertar la imagen, se recupera de la URL una vez y se almacena una copia para mostrar en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no deben superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

La URL proporcionada no debe superar los 2 KB.

Parámetros

NombreTipoDescripción
imageUrlStringLa URL desde la que se descargará la imagen.
cropBooleanSi el valor es true, se recorta la imagen para adaptarla al tamaño existente. De lo contrario, la imagen se escala y se centra.

Volver

Image: Este Image después del reemplazo

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

scaleHeight(ratio)

Ajusta la altura del elemento según la proporción especificada. La altura del elemento es la altura del cuadro de límite cuando el elemento no tiene rotación.

Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Parámetros

NombreTipoDescripción
ratioNumberProporción para ajustar la altura de este elemento de página.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

scaleWidth(ratio)

Ajusta el ancho del elemento según la proporción especificada. El ancho del elemento es el ancho del cuadro de límite cuando el elemento no tiene rotación.

Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Parámetros

NombreTipoDescripción
ratioNumberProporción para ajustar el ancho de este elemento de página.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

select()

Selecciona solo el PageElement en la presentación activa y quita cualquier selección anterior. Esto es lo mismo que llamar a select(replace) con true.

Una secuencia de comandos solo puede acceder a la selección del usuario que ejecuta la secuencia de comandos y solo si la secuencia está vinculada a la presentación.

Esto establece el Page superior de PageElement como current page selection. 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

select(replace)

Selecciona el PageElement en la presentación activa.

Una secuencia de comandos solo puede acceder a la selección del usuario que ejecuta la secuencia de comandos y solo si la secuencia está vinculada a la presentación.

Pasa true a este método para seleccionar solo el PageElement y quitar cualquier selección anterior. Esto también establece el Page superior de PageElement como current page selection.

Pasa false para seleccionar varios objetos PageElement. Los objetos PageElement deben estar en el mismo Page.

Se deben cumplir las siguientes condiciones cuando se selecciona un elemento de página mediante un parámetro false:

  1. El Page superior del objeto PageElement debe ser current page selection.
  2. No debe haber varios objetos Page seleccionados.

Para asegurarte de que ese sea el enfoque preferido, primero selecciona el elemento Page principal con Page.selectAsCurrentPage() y, luego, los elementos de esa página. 

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parámetros

NombreTipoDescripción
replaceBooleanSi es true, la selección reemplaza cualquier selección anterior; de lo contrario, la selección se agrega a cualquier selección anterior.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

sendBackward()

Envía el elemento de página hacia atrás en la página por un elemento.

El elemento de la página no debe estar en un grupo.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

sendToBack()

Envía el elemento de página al final de la página.

El elemento de la página no debe estar en un grupo.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setDescription(description)

Establece la descripción del texto alternativo del elemento de página.

El método no es compatible con los elementos Group. 

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parámetros

NombreTipoDescripción
descriptionStringCadena en la que se va a establecer la descripción de texto alternativo

Volver

Image: Este elemento de la página.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setHeight(height)

Establece la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando el elemento no tiene rotación.

Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Parámetros

NombreTipoDescripción
heightNumberLa nueva altura de este elemento de la página, en puntos.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLeft(left)

Establece la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la página, cuando el elemento no tiene rotación.

Parámetros

NombreTipoDescripción
leftNumberLa nueva posición horizontal que se establecerá, en puntos.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slideIndex)

Establece un Link para la Slide determinada mediante el índice basado en cero de la diapositiva. 

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Parámetros

NombreTipoDescripción
slideIndexIntegerEs el índice basado en cero de la diapositiva.

Volver

Link: Es el Link que se estableció.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slide)

Establece un Link en la Slide determinada. El vínculo se establece en el ID de la diapositiva determinada. 

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Parámetros

NombreTipoDescripción
slideSlideEl Slide que se vinculará.

Volver

Link: Es el Link que se estableció.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slidePosition)

Establece un Link para la Slide determinada usando la posición relativa de la diapositiva. 

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Parámetros

NombreTipoDescripción
slidePositionSlidePositionEl SlidePosition relativo.

Volver

Link: Es el Link que se estableció.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkUrl(url)

Establece un Link para la string de URL no vacía especificada. 

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Parámetros

NombreTipoDescripción
urlStringLa string de la URL.

Volver

Link: Es el Link que se estableció.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setRotation(angle)

Establece el ángulo de rotación del elemento en sentido horario alrededor del centro en grados.

Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Parámetros

NombreTipoDescripción
angleNumberEl nuevo ángulo de rotación en el sentido de las manecillas del reloj para establecerlo, en grados.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTitle(title)

Establece el título del texto alternativo del elemento de la página.

El método no es compatible con los elementos Group. 

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parámetros

NombreTipoDescripción
titleStringCadena en la que se debe configurar el título del texto alternativo

Volver

Image: Este elemento de la página.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTop(top)

Establece la posición vertical del elemento en puntos, medida desde la esquina superior izquierda de la página, cuando el elemento no tiene rotación.

Parámetros

NombreTipoDescripción
topNumberLa nueva posición vertical que se configurará, en puntos.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTransform(transform)

Establece la transformación del elemento de la página con la transformación proporcionada.

La actualización de la transformación de un grupo cambia la transformación absoluta de los elementos de página de ese grupo, lo que puede cambiar su apariencia visual.

Actualizar la transformación de un elemento de página que está en un grupo solo cambia la transformación de ese elemento de la página; no afecta las transformaciones del grupo ni otros elementos de página del grupo.

Para obtener detalles sobre cómo las transformaciones afectan la apariencia visual de los elementos de la página, consulta getTransform().

Parámetros

NombreTipoDescripción
transformAffineTransformLa transformación que se configura para este elemento de página.

Volver

Image: Este elemento para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setWidth(width)

Establece el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando el elemento no tiene rotación.

Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.

Parámetros

NombreTipoDescripción
widthNumberEs el nuevo ancho de este elemento de página, establecido en puntos.

Volver

Image: Es el elemento de esta página, para el encadenamiento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations