Es un elemento PageElement
que representa una imagen.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
alignOnPage(alignmentPosition) | Image | Alinea el elemento con la posición de alineación especificada en la página. |
bringForward() | Image | Mueve el elemento de la página hacia adelante en la página un elemento. |
bringToFront() | Image | Coloca el elemento de página al principio de la página. |
duplicate() | PageElement | Duplica el elemento de la página. |
getAs(contentType) | Blob | Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado. |
getBlob() | Blob | Muestra los datos dentro de esta imagen como un BLOB. |
getBorder() | Border | Muestra el Border de la imagen. |
getConnectionSites() | ConnectionSite[] | Muestra la lista de ConnectionSite en el elemento de página, o una lista vacía si la página
elemento no tiene ningún sitio de conexión. |
getContentUrl() | String | Obtiene una URL para la imagen. |
getDescription() | String | Muestra la descripción de texto alternativo del elemento de página. |
getHeight() | Number | Obtiene la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando el elemento elemento no tiene rotación. |
getInherentHeight() | Number | Muestra la altura inherente del elemento en puntos. |
getInherentWidth() | Number | Muestra el ancho inherente del elemento en puntos. |
getLeft() | Number | Devuelve la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la cuando el elemento no tiene rotación. |
getLink() | Link | Muestra Link o null si no hay un vínculo. |
getObjectId() | String | Muestra el ID único de este objeto. |
getPageElementType() | PageElementType | Muestra el tipo de elemento de página, representado como una enumeración PageElementType . |
getParentGroup() | Group | Muestra el grupo al que pertenece este elemento de página, o null si el elemento no está en una
grupo. |
getParentPage() | Page | Muestra la página en la que se encuentra este elemento de página. |
getParentPlaceholder() | PageElement | Muestra el elemento de la página superior del marcador de posición. |
getPlaceholderIndex() | Integer | Muestra el índice de la imagen del marcador de posición. |
getPlaceholderType() | PlaceholderType | Muestra el tipo de marcador de posición de la imagen, o PlaceholderType.NONE si la forma no lo es.
un marcador de posición. |
getRotation() | Number | Muestra en grados el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro, donde es cero grados significa que no hay rotación. |
getSourceUrl() | String | Obtiene la URL de origen de la imagen, si está disponible. |
getTitle() | String | Muestra el título de texto alternativo del elemento de página. |
getTop() | Number | 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. |
getTransform() | AffineTransform | Muestra la transformación del elemento de página. |
getWidth() | Number | Devuelve 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) | Image | Preconcatena la transformación proporcionada en la transformación existente del elemento de página. |
remove() | void | Quita el elemento de página. |
removeLink() | void | Quita un Link . |
replace(blobSource) | Image | Reemplaza esta imagen con una que se describe mediante un objeto BlobSource . |
replace(blobSource, crop) | Image | Reemplaza esta imagen por una que se describe por un objeto Image y, si lo deseas, puede recortarla
la imagen para que se ajuste. |
replace(imageUrl) | Image | Reemplaza esta imagen por otra imagen descargada de la URL proporcionada. |
replace(imageUrl, crop) | Image | Reemplaza esta imagen por otra descargada de la URL proporcionada y, si lo deseas, puede recortarla la imagen para que se ajuste. |
scaleHeight(ratio) | Image | Ajusta la altura del elemento según la proporción especificada. |
scaleWidth(ratio) | Image | Ajusta el ancho del elemento según la proporción especificada. |
select() | void | Selecciona solo la PageElement en la presentación activa y quita las anteriores
selección. |
select(replace) | void | Selecciona el PageElement en la presentación activa. |
sendBackward() | Image | Envía un elemento hacia atrás en la página. |
sendToBack() | Image | Envía el elemento de página al final de la página. |
setDescription(description) | Image | Establece la descripción de texto alternativo del elemento de página. |
setHeight(height) | Image | Establece la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando elemento no tiene rotación. |
setLeft(left) | Image | Establece la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la cuando el elemento no tiene rotación. |
setLinkSlide(slideIndex) | Link | Establece un Link en el Slide determinado con el índice basado en cero de la diapositiva. |
setLinkSlide(slide) | Link | Establece un Link para la Slide determinada, el vínculo se establece con el ID de diapositiva dado. |
setLinkSlide(slidePosition) | Link | Establece un elemento Link en el elemento Slide determinado usando la posición relativa de la diapositiva. |
setLinkUrl(url) | Link | Configura un Link para una cadena de URL que no está vacía. |
setRotation(angle) | Image | Fija en grados el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro. |
setTitle(title) | Image | Establece el título de texto alternativo del elemento de página. |
setTop(top) | Image | 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. |
setTransform(transform) | Image | Establece la transformación del elemento de página con la transformación proporcionada. |
setWidth(width) | Image | Establece el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando el elemento elemento no tiene rotación. |
Documentación detallada
alignOnPage(alignmentPosition)
Alinea el elemento con la posición de alineación especificada en la página.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
alignmentPosition | AlignmentPosition | Es la posición con la que se alineará este elemento de página en la página. |
Volver
Image
: Este elemento de página para el encadenamiento.
bringForward()
Mueve el elemento de la página hacia adelante en la página un elemento.
El elemento de página no debe estar en un grupo.
Volver
Image
: Este elemento de 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()
Coloca el elemento de página al principio de la página.
El elemento de página no debe estar en un grupo.
Volver
Image
: Este elemento de 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 la 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 dentro de este objeto como un BLOB convertido al tipo de contenido especificado. Esta agrega la extensión adecuada al nombre del archivo, por ejemplo, "miarchivo.pdf". Sin embargo, supone que la parte del nombre de archivo que sigue al último punto (si corresponde) es una parte extensión que debe reemplazarse. Por lo tanto, "ShoppingList.12.25.2014" se convierte en “ShoppingList.12.25.pdf”.
Para ver las cuotas diarias de las conversiones, consulta Cuotas para Google Servicios Es posible que los dominios de Google Workspace recién creados estén sujetos temporalmente a restricciones y cuotas.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
contentType | String | El tipo de MIME en el que se convertirá. Para la mayoría de los BLOB, 'application/pdf' es
la única opción válida. En el caso de las imágenes en formato BMP, GIF, JPEG o PNG, también se aplica cualquiera de los siguientes valores: 'image/bmp' , 'image/gif' , 'image/jpeg' o 'image/png' .
válido. 'text/markdown' también es válido para Documentos de Google. |
Volver
Blob
: Los datos como un BLOB.
getBlob()
Muestra los datos dentro de esta imagen como un BLOB.
Volver
Blob
: Son los datos de la imagen como un BLOB.
getBorder()
Muestra el Border
de la imagen.
Volver
Border
: Es 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 página, o una lista vacía si la página
elemento 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 para la imagen.
Esta URL está etiquetada con la cuenta del solicitante, por lo que cualquier persona que la tenga accede a la imagen como el solicitante original. Es posible que se pierda el acceso a la imagen si cambios en la configuración de uso compartido de la presentación. La URL que se muestra vence después de un período breve.
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 texto alternativo.
Volver
String
: Es la descripción 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
getHeight()
Obtiene la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando el elemento 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 están compatible con este método, consulta la limitaciones de tamaño y posicionamiento.
Volver
Number
: Indica la altura inherente en puntos del elemento de página, o null
si el elemento de página lo hace.
no tienen 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 es relativa a su tamaño inherente. Usa el tamaño inherente en junto con la transformación del elemento para determinar su aspecto visual final.
Volver
Number
: Indica la altura inherente en puntos del elemento de página, o null
si el elemento de página lo hace.
no tienen 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 es relativa a su tamaño inherente. Usa el tamaño inherente en junto con la transformación del elemento para determinar su aspecto visual final.
Volver
Number
: Indica el ancho inherente del elemento de página en puntos o null
si el elemento de página lo hace.
no tienen 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()
Devuelve la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la cuando el elemento no tiene rotación.
Volver
Number
: Es la posición horizontal en puntos de este elemento 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
getLink()
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
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 IDs de objeto utilizados por páginas y 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 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 página, o null
si el elemento no está en una
grupo.
Volver
Group
: Es el grupo al que pertenece este elemento de 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 de página.
Volver
Page
: Es la página en la que se encuentra 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 la página superior del marcador de posición. Muestra null
si la imagen no es una
marcador de posición o no tiene un elemento superior.
Volver
PageElement
: Es el elemento de la página principal de este marcador de posición de imagen, o bien null
si no es la imagen.
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 hay dos o más marcadores de posición de imágenes en la misma página
son del mismo tipo, cada una tiene un valor de índice único. Muestra null
si la imagen no está presente.
un marcador de posición.
Volver
Integer
: Es 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 lo 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 en grados el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro, donde es 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 mediante una URL, muestra la URL proporcionada durante la inserción de la imagen.
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 página. El título se combina con la descripción para mostrar y leer 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 en puntos de este elemento 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 página.
La apariencia visual del elemento de página está determinada por su transformación absoluta. Para calcular la transformación absoluta, preconcatenar la transformación de un elemento de página con las transformaciones de todos sus grupos superiores. Si el elemento de página no está en un grupo, su transformación absoluta se el mismo que el de este campo.
Volver
AffineTransform
: La transformación 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
getWidth()
Devuelve 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 están compatible con este método, consulta la limitaciones de tamaño y posicionamiento.
Volver
Number
: Indica el ancho inherente del elemento de página en puntos o null
si el elemento de página lo hace.
no tienen 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)
Preconcatena la transformación proporcionada en la transformación existente del elemento de 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 página por setTransform(transform)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
transform | AffineTransform | La transformación que se preconcatena en la transformación de este elemento de página. |
Volver
Image
: Este elemento de 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 página.
Si, luego de una operación de eliminación, un Group
contiene solo un elemento de página o ninguno, el elemento
el grupo en sí.
Si se quita un marcador de posición PageElement
de un diseño maestro o de un diseño, cualquier elemento
los marcadores 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
removeLink()
Quita un Link
.
shape.removeLink();
replace(blobSource)
Reemplaza esta imagen con una que se describe mediante un objeto BlobSource
.
Si insertas la imagen, se recupera de
BlobSource
una vez y se almacena una copia para mostrarla dentro de la presentación.
Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar
PNG, JPEG o GIF.
Para mantener la relación de aspecto, esta se ajusta y se centra con respecto del 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
Nombre | Tipo | Descripción |
---|---|---|
blobSource | BlobSource | Los datos de la imagen |
Volver
Image
: Este valor es 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 se describe por un objeto Image
y, si lo deseas, puede recortarla
la imagen para que se ajuste.
Si insertas la imagen, se recupera de
BlobSource
una vez y se almacena una copia para mostrarla dentro de la presentación.
Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y deben estar
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
Nombre | Tipo | Descripción |
---|---|---|
blobSource | BlobSource | Los datos de la imagen |
crop | Boolean | Si es true , recorta la imagen para adaptarla al tamaño existente. De lo contrario, el
que la imagen se ajuste y esté centrada. |
Volver
Image
: Este valor es 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 imagen descargada de la URL proporcionada.
Cuando insertas la imagen, se recupera de la URL una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y en formato PNG, JPEG o GIF.
La URL proporcionada debe ser de acceso público y no debe superar los 2 KB. La URL se guarda
con la imagen y se expone a través de getSourceUrl()
.
Para mantener la relación de aspecto, esta se ajusta y se centra con respecto del tamaño de la imagen existente.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
imageUrl | String | La URL de la que se descargará la imagen. |
Volver
Image
: Este valor es 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 descargada de la URL proporcionada y, si lo deseas, puede recortarla la imagen para que se ajuste.
Cuando insertas la imagen, se recupera de la URL una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y en formato PNG, JPEG o GIF.
La URL proporcionada no debe superar los 2 KB.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
imageUrl | String | La URL de la que se descargará la imagen. |
crop | Boolean | Si es true , recorta la imagen para adaptarla al tamaño existente. De lo contrario, el
que la imagen se ajuste y esté centrada. |
Volver
Image
: Este valor es 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 de su cuadro delimitador 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 están compatible con este método, consulta la limitaciones de tamaño y posicionamiento.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
ratio | Number | Proporción para ajustar la altura de este elemento de página. |
Volver
Image
: Este elemento de 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 de su cuadro delimitador 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 están compatible con este método, consulta la limitaciones de tamaño y posicionamiento.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
ratio | Number | La proporción en la que se escala el ancho de este elemento de página. |
Volver
Image
: Este elemento de 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 la PageElement
en la presentación activa y quita las anteriores
selección. 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 la ejecuta y solo si La secuencia de comandos está vinculada a la presentación.
De esta manera, se establece el elemento superior Page
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 la ejecuta y solo si La secuencia de comandos está vinculada a la presentación.
Pasa true
a este método para seleccionar solo el PageElement
y quitar cualquiera
la selección anterior. Esto también establece el elemento superior Page
de PageElement
como el
current page selection
Pasa false
para seleccionar varios objetos PageElement
. El PageElement
Los objetos deben estar en el mismo Page
.
Cuando se selecciona un elemento de página con una false
, se deben cumplir las siguientes condiciones
parámetro:
- El elemento superior
Page
del objetoPageElement
debe sercurrent page selection
. - No debe haber varios objetos
Page
seleccionados.
Para garantizar que así sea, el enfoque preferido es seleccionar el Page
superior.
Primero, usa Page.selectAsCurrentPage()
y, luego, selecciona los elementos de página que contiene.
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
Nombre | Tipo | Descripción |
---|---|---|
replace | Boolean | Si es true , la selección reemplaza cualquier selección anterior. De lo contrario,
una nueva selección se agregará 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 un elemento hacia atrás en la página.
El elemento de página no debe estar en un grupo.
Volver
Image
: Este elemento de 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 página no debe estar en un grupo.
Volver
Image
: Este elemento de 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 de texto alternativo del elemento de página.
El método no es compatible con 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
Nombre | Tipo | Descripción |
---|---|---|
description | String | Cadena en la que se configura la descripción de texto alternativo. |
Volver
Image
: 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
setHeight(height)
Establece la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando 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 están compatible con este método, consulta la limitaciones de tamaño y posicionamiento.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
height | Number | La nueva altura del elemento de página que se va a establecer, en puntos. |
Volver
Image
: Este elemento de 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 cuando el elemento no tiene rotación.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
left | Number | La nueva posición horizontal que se va a establecer, en puntos. |
Volver
Image
: Este elemento de 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
en el Slide
determinado con el índice basado en cero de la diapositiva.
// Set a link to the first slide of the presentation. shape.setLinkSlide(0);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
slideIndex | Integer | 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
para la Slide
determinada, el vínculo se establece con el ID de diapositiva dado.
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; shape.setLinkSlide(slide);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
slide | Slide | El 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 elemento Link
en el elemento Slide
determinado 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
Nombre | Tipo | Descripción |
---|---|---|
slidePosition | SlidePosition | Es el 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)
Configura un Link
para una cadena de URL que no está vacía.
// Set a link to the URL. shape.setLinkUrl("https://slides.google.com");
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
url | String | Es la cadena de 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)
Fija en grados el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de la página no están compatible con este método, consulta la limitaciones de tamaño y posicionamiento.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
angle | Number | El nuevo ángulo de rotación en el sentido de las manecillas del reloj que se va a establecer, en grados. |
Volver
Image
: Este elemento de 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 de texto alternativo del elemento de página.
El método no es compatible con 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
Nombre | Tipo | Descripción |
---|---|---|
title | String | Cadena en la que se establecerá el título de texto alternativo. |
Volver
Image
: 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
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
Nombre | Tipo | Descripción |
---|---|---|
top | Number | La nueva posición vertical que se va a establecer, en puntos. |
Volver
Image
: Este elemento de 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 página con la transformación proporcionada.
Actualizar la transformación de un grupo cambia la transformación absoluta de los elementos de página en 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 página; Esto no afecta las transformaciones del grupo ni otros elementos de la página en la grupo.
Para obtener detalles sobre cómo las transformaciones afectan la apariencia visual de los elementos de página, consulta getTransform()
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
transform | AffineTransform | La transformación que se establece 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 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 están compatible con este método, consulta la limitaciones de tamaño y posicionamiento.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
width | Number | El nuevo ancho del elemento de página que se establecerá, en puntos. |
Volver
Image
: Este elemento de 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