Se usó la API de Cloud Translation para traducir esta página.

Class Group

Una colección de PageElement unidas como una sola unidad.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`alignOnPage(alignmentPosition)`	`Group`	Alinea el elemento con la posición de alineación especificada en la página.
`bringForward()`	`Group`	Mueve el elemento de la página hacia adelante en la página un elemento.
`bringToFront()`	`Group`	Coloca el elemento de página al principio de la página.
`duplicate()`	`PageElement`	Duplica el elemento de la página.
`getChildren()`	`PageElement[]`	Obtiene la colección de los elementos de página del grupo.
`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.
`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.
`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.
`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.
`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`	Obtiene 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)`	`Group`	Preconcatena la transformación proporcionada en la transformación existente del elemento de página.
`remove()`	`void`	Quita el elemento de página.
`scaleHeight(ratio)`	`Group`	Ajusta la altura del elemento según la proporción especificada.
`scaleWidth(ratio)`	`Group`	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()`	`Group`	Envía un elemento hacia atrás en la página.
`sendToBack()`	`Group`	Envía el elemento de página al final de la página.
`setDescription(description)`	`Group`	Establece la descripción de texto alternativo del elemento de página.
`setHeight(height)`	`Group`	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)`	`Group`	Establece la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la cuando el elemento no tiene rotación.
`setRotation(angle)`	`Group`	Fija en grados el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro.
`setTitle(title)`	`Group`	Establece el título de texto alternativo del elemento de página.
`setTop(top)`	`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.
`setTransform(transform)`	`Group`	Establece la transformación del elemento de página con la transformación proporcionada.
`setWidth(width)`	`Group`	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.
`ungroup()`	`void`	Desagrupa los elementos del grupo.

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

Group: 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

Group: 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

Group: 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

`getChildren()`

Obtiene la colección de los elementos de página del grupo. El tamaño mínimo de un grupo es 2.

Volver

PageElement[]: Es la lista de elementos de página en este grupo.

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

`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

`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

`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

`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()`

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

La transformación inicial para una Group recién creada es siempre la transformación de identidad: parámetros de escala de 1.0 y parámetros de distorsión y traslación de 0.0.

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.

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

Group: 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

`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.

Parámetros

Nombre	Tipo	Descripción
`ratio`	`Number`	Proporción para ajustar la altura de este elemento de página.

Volver

Group: 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.

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

Group: 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 objeto PageElement debe ser current 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

Group: 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

Group: 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

Group: 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.

Parámetros

Nombre	Tipo	Descripción
`height`	`Number`	La nueva altura del elemento de página que se va a establecer, en puntos.

Volver

Group: 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

Group: 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

`setRotation(angle)`

Fija en grados el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro.

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

Group: 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

Group: 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

Group: 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

Group: 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.

Parámetros

Nombre	Tipo	Descripción
`width`	`Number`	El nuevo ancho del elemento de página que se establecerá, en puntos.

Volver

Group: 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

`ungroup()`

Desagrupa los elementos del grupo.

Se quita el grupo en sí.

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 alcances:

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