Es una colección de Page
unidos como una sola unidad.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
align | Group | Alinea el elemento con la posición de alineación especificada en la página. |
bring | Group | Avanza el elemento de página en la página un elemento. |
bring | Group | Coloca el elemento de página en la parte frontal de la página. |
duplicate() | Page | Duplica el elemento de página. |
get | Page | Obtiene la colección de elementos de página del grupo. |
get | Connection | Muestra la lista de Connection en el elemento de página o una lista vacía si el elemento de página no tiene ningún sitio de conexión. |
get | String | Muestra la descripción del texto alternativo del elemento de página. |
get | Number | Obtiene la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando este no tiene rotación. |
get | Number | Muestra la altura inherente del elemento en puntos. |
get | Number | Muestra el ancho inherente del elemento en puntos. |
get | Number | 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. |
get | String | Muestra el ID único de este objeto. |
get | Page | Muestra el tipo del elemento de página, representado como una enumeración Page . |
get | Group | Muestra el grupo al que pertenece este elemento de página o null si el elemento no está en un grupo. |
get | Page | Muestra la página en la que se encuentra este elemento de página. |
get | Number | Muestra el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro en grados, donde cero grados significa que no hay rotación. |
get | String | Muestra el título del texto alternativo del elemento de página. |
get | 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. |
get | Affine | Obtiene la transformación del elemento de página. |
get | Number | Muestra el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando este no tiene rotación. |
preconcatenate | Group | Preconecta la transformación proporcionada con la transformación existente del elemento de página. |
remove() | void | Quita el elemento de página. |
scale | Group | Escala la altura del elemento según la proporción especificada. |
scale | Group | Escala el ancho del elemento según la proporción especificada. |
select() | void | Selecciona solo el Page en la presentación activa y quita cualquier selección anterior. |
select(replace) | void | Selecciona el Page en la presentación activa. |
send | Group | Envía el elemento de página hacia atrás en la página por un elemento. |
send | Group | Envía el elemento de página al final de la página. |
set | Group | Establece la descripción del texto alternativo del elemento de página. |
set | Group | Establece la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando este no tiene rotación. |
set | Group | 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. |
set | Group | Establece el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro en grados. |
set | Group | Establece el título del texto alternativo del elemento de página. |
set | Group | 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. |
set | Group | Establece la transformación del elemento de página con la transformación proporcionada. |
set | Group | Establece el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando este no tiene rotación. |
ungroup() | void | Desagrupa los elementos del grupo. |
Documentación detallada
align On Page(alignmentPosition)
Alinea el elemento con la posición de alineación especificada en la página.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
alignment | Alignment | Es la posición en la que se alinea este elemento de página. |
Volver
Group
: Este elemento de página se usa para encadenar.
bring Forward()
Avanza el elemento de página en la página un elemento.
El elemento de página no debe estar en un grupo.
Volver
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bring To Front()
Coloca el elemento de página en la parte frontal de la página.
El elemento de página no debe estar en un grupo.
Volver
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
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 y en la misma posición que el original.
Volver
Page
: 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Children()
Obtiene la colección de elementos de página del grupo. El tamaño mínimo de un grupo es 2.
Volver
Page
: Es la lista de elementos de página de este grupo.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Connection Sites()
Muestra la lista de Connection
en el elemento de página o una lista vacía si el elemento de página no tiene ningún sitio de conexión.
Volver
Connection
: 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Description()
Muestra la descripción del 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 del 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Height()
Obtiene la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando este no tiene rotación.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.
Volver
Number
: Es 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Inherent Height()
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 intrínseco junto con la transformación del elemento para determinar su apariencia visual final.
Volver
Number
: Es 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Inherent Width()
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 intrínseco junto con la transformación del elemento para determinar su apariencia visual final.
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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Left()
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 horizontal 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Object Id()
Muestra el ID único de este objeto. Los IDs de objeto que usan las páginas y los elementos de página comparten el mismo espacio de nombres.
Volver
String
: Es 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Element Type()
Muestra el tipo del elemento de página, representado como una enumeración Page
.
Volver
Page
: 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Parent Group()
Muestra el grupo al que pertenece este elemento de página o null
si el elemento no está en un 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Parent Page()
Muestra la página en la que se encuentra este elemento de página.
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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Rotation()
Muestra el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro en grados, donde cero grados significa que no hay rotación.
Volver
Number
: Es el ángulo de rotación en grados entre 0 (incluido) y 360 (excluido).
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Title()
Muestra el título del texto alternativo del elemento de página. El título se combina con la descripción para mostrar y leer el texto alternativo.
Volver
String
: Es el título del 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Top()
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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Transform()
Obtiene la transformación del elemento de página.
La transformación inicial de un Group
creado recientemente siempre es la transformación de identidad: parámetros de escala de 1.0 y parámetros de corte y traslación de 0.0.
Volver
Affine
: Es 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Width()
Muestra el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando este no tiene rotación.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenate Transform(transform)
Preconecta la transformación proporcionada con 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:
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
También puedes reemplazar la transformación del elemento de página por set
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
transform | Affine | Es la transformación que se preconcatenará en la transformación de este elemento de página. |
Volver
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Quita el elemento de página.
Si, después de una operación de eliminación, un Group
contiene solo uno o ningún elemento de página, también se quita el
grupo.
Si se quita un marcador de posición Page
en un elemento principal o de diseño, también se quitan los marcadores de posición de herencia vacíos.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scale Height(ratio)
Escala la altura del elemento según la proporción especificada. La altura del elemento es la altura de su 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 página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
ratio | Number | Es la proporción con la que se escalará la altura de este elemento de página. |
Volver
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scale Width(ratio)
Escala el ancho del elemento según la proporción especificada. El ancho del elemento es el ancho de su 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 página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
ratio | Number | Es la proporción con la que se escalará el ancho de este elemento de página. |
Volver
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Selecciona solo el Page
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 la ejecuta y solo si está vinculada a la presentación.
Esto establece el Page
superior de Page
como current page selection
.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
Selecciona el Page
en la presentación activa.
Una secuencia de comandos solo puede acceder a la selección del usuario que la ejecuta y solo si está vinculada a la presentación.
Pasa true
a este método para seleccionar solo el Page
y quitar cualquier selección anterior. Esto también establece el Page
superior del Page
como el current page selection
.
Pasa false
para seleccionar varios objetos Page
. Los objetos Page
deben estar en el mismo Page
.
Se deben cumplir las siguientes condiciones cuando se selecciona un elemento de página con un parámetro false
:
- El
Page
superior del objetoPage
debe serElement current page selection
. - No debe haber varios objetos
Page
seleccionados.
Para asegurarte de que ese sea el caso, el enfoque preferido es seleccionar primero el Page
superior con Page.selectAsCurrentPage()
y, luego, seleccionar los elementos de la página en esa página.
const 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. const pageElements = slide.getPageElements(); for (let 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, 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 ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
send Backward()
Envía el elemento de página hacia atrás en la página por un elemento.
El elemento de página no debe estar en un grupo.
Volver
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
send To Back()
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
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Description(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". const 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 | Es la cadena en la que se establecerá la descripción del texto alternativo. |
Volver
Group
: Es el elemento de esta página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Height(height)
Establece la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando este no tiene rotación.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
height | Number | Es la nueva altura de este elemento de página que se establecerá, en puntos. |
Volver
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Left(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
Nombre | Tipo | Descripción |
---|---|---|
left | Number | Es la nueva posición horizontal que se establecerá, en puntos. |
Volver
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Rotation(angle)
Establece el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro en grados.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
angle | Number | Es el nuevo ángulo de rotación en el sentido de las manecillas del reloj que se debe establecer, en grados. |
Volver
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Title(title)
Establece el título 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 title to "new alt text title". const 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 | Es la cadena en la que se establecerá el título del texto alternativo. |
Volver
Group
: Es el elemento de esta página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Top(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 | Es la nueva posición vertical que se establecerá, en puntos. |
Volver
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Transform(transform)
Establece la transformación del elemento de página con la transformación proporcionada.
Si actualizas la transformación de un grupo, se cambia la transformación absoluta de los elementos de la página en ese grupo, lo que puede cambiar su apariencia visual.
Si actualizas la transformación de un elemento de página que está en un grupo, solo se cambiará la transformación de ese elemento de página, no se verán afectadas las transformaciones del grupo ni de 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 get
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
transform | Affine | Es la transformación que se establece para este elemento de página. |
Volver
Group
: Este elemento es para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Width(width)
Establece el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando este no tiene rotación.
Este método no es compatible con todos los elementos de la página. Para saber qué elementos de página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
width | Number | Es el nuevo ancho de este elemento de página que se establecerá, en puntos. |
Volver
Group
: Este elemento de página se usa para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
ungroup()
Desagrupa los elementos del grupo.
Se quita el grupo.
No se pueden desagrupar los grupos dentro de otros grupos.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations