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

Class Shape

Es un objeto PageElement que representa una forma genérica que no tiene una clasificación más específica. Incluye cuadros de texto, rectángulos y otras formas predefinidas.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`alignOnPage(alignmentPosition)`	`Shape`	Alinea el elemento con la posición de alineación especificada en la página.
`bringForward()`	`Shape`	Mueve el elemento de la página hacia adelante en la página un elemento.
`bringToFront()`	`Shape`	Coloca el elemento de página al principio de la página.
`duplicate()`	`PageElement`	Duplica el elemento de la página.
`getAutofit()`	`Autofit`	Muestra el `Autofit` del texto dentro de esta forma.
`getBorder()`	`Border`	Muestra el `Border` de la forma.
`getConnectionSites()`	`ConnectionSite[]`	Muestra la lista de `ConnectionSite` 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.
`getContentAlignment()`	`ContentAlignment`	Muestra el `ContentAlignment` del texto en la forma.
`getDescription()`	`String`	Muestra la descripción de texto alternativo del elemento de página.
`getFill()`	`Fill`	Muestra el `Fill` de la forma.
`getHeight()`	`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.
`getInherentHeight()`	`Number`	Muestra la altura inherente del elemento en puntos.
`getInherentWidth()`	`Number`	Muestra el ancho inherente del elemento en puntos.
`getLeft()`	`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.
`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 un 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 marcador de posición de la forma.
`getPlaceholderType()`	`PlaceholderType`	Muestra el tipo de marcador de posición de la forma o `PlaceholderType.NONE` si la forma no es un marcador de posición.
`getRotation()`	`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.
`getShapeType()`	`ShapeType`	Muestra el tipo de forma.
`getText()`	`TextRange`	Muestra el contenido de texto de la forma.
`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`	Muestra el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando el elemento no tiene rotación.
`preconcatenateTransform(transform)`	`Shape`	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`.
`replaceWithImage(blobSource)`	`Image`	Reemplaza esta forma con una imagen proporcionada por un elemento `BlobSource`.
`replaceWithImage(blobSource, crop)`	`Image`	Reemplaza esta forma con una imagen proporcionada por un elemento `BlobSource`.
`replaceWithImage(imageUrl)`	`Image`	Reemplaza esta forma por una imagen.
`replaceWithImage(imageUrl, crop)`	`Image`	Reemplaza esta forma por una imagen.
`replaceWithSheetsChart(sourceChart)`	`SheetsChart`	Reemplaza esta forma por un gráfico de Hojas de cálculo de Google.
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	Reemplaza esta forma por una imagen de un gráfico de Hojas de cálculo de Google.
`scaleHeight(ratio)`	`Shape`	Ajusta la altura del elemento según la proporción especificada.
`scaleWidth(ratio)`	`Shape`	Ajusta el ancho del elemento según la proporción especificada.
`select()`	`void`	Selecciona solo el `PageElement` en la presentación activa y quita cualquier selección anterior.
`select(replace)`	`void`	Selecciona el `PageElement` en la presentación activa.
`sendBackward()`	`Shape`	Envía un elemento hacia atrás en la página.
`sendToBack()`	`Shape`	Envía el elemento de página al final de la página.
`setContentAlignment(contentAlignment)`	`Shape`	Establece el `ContentAlignment` del texto en la forma.
`setDescription(description)`	`Shape`	Establece la descripción de texto alternativo del elemento de página.
`setHeight(height)`	`Shape`	Establece la altura del elemento en puntos, que es la altura del cuadro de límite del elemento cuando este no tiene rotación.
`setLeft(left)`	`Shape`	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.
`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)`	`Shape`	Fija en grados el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro.
`setTitle(title)`	`Shape`	Establece el título de texto alternativo del elemento de página.
`setTop(top)`	`Shape`	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)`	`Shape`	Establece la transformación del elemento de página con la transformación proporcionada.
`setWidth(width)`	`Shape`	Establece el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando este 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.

Devolvedor

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

Devolvedor

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

Devolvedor

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

Devolvedor

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

`getAutofit()`

Muestra el Autofit del texto dentro de esta forma. Es null si la forma no permite texto.

Devolvedor

Autofit: Es el ajuste automático del texto dentro de esta forma.

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

`getBorder()`

Muestra el Border de la forma.

Devolvedor

Border: Es la configuración de borde de esta forma.

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 el elemento de página no tiene ningún sitio de conexión.

Devolvedor

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

`getContentAlignment()`

Muestra el ContentAlignment del texto en la forma.

Devolvedor

ContentAlignment: Es la alineación del texto dentro de esta forma.

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.

Devolvedor

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

`getFill()`

Muestra el Fill de la forma.

Devolvedor

Fill: Es la configuración de relleno de esta forma.

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

Devolvedor

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

Autorización

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

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

`getInherentHeight()`

Muestra la altura inherente del elemento en puntos.

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

Devolvedor

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

Autorización

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

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

`getInherentWidth()`

Muestra el ancho inherente del elemento en puntos.

Devolvedor

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

Autorización

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

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

`getLeft()`

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

Devolvedor

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());
}

Devolvedor

Link

Autorización

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

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

`getObjectId()`

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

Devolvedor

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.

Devolvedor

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 un grupo.

Devolvedor

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.

Devolvedor

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 forma no es un marcador de posición o no tiene un elemento superior.

Devolvedor

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

Autorización

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

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

`getPlaceholderIndex()`

Muestra el índice de marcador de posición de la forma. Si hay dos o más instancias del mismo tipo de marcador de posición en la misma página, cada una tendrá su propio valor de índice único. Muestra null si la forma no es un marcador de posición.

Devolvedor

Integer: Es el índice de marcador de posición de esta forma, o bien null si la forma 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 forma o PlaceholderType.NONE si la forma no es un marcador de posición.

Devolvedor

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

Autorización

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

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

`getRotation()`

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

Devolvedor

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

`getShapeType()`

Muestra el tipo de forma.

Devolvedor

ShapeType: Es el tipo de esta forma.

`getText()`

Muestra el contenido de texto de la forma.

El texto dentro de una forma siempre termina con un carácter de línea nueva.

Devolvedor

TextRange: Es el contenido de texto de esta forma.

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.

Devolvedor

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.

Devolvedor

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, debes 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 es la misma que el valor de este campo.

Devolvedor

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

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

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

Devolvedor

Number: Es el ancho inherente del elemento de página en puntos, o bien null si el elemento de página no tiene 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.

Devolvedor

Shape: 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, después de una operación de eliminación, un Group contiene solo un elemento de página o ninguno, también se quita el grupo en sí.

Si se quita un marcador de posición PageElement de un diseño maestro o de un diseño, también se quita cualquier marcador de posición heredado vacío.

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

`replaceWithImage(blobSource)`

Reemplaza esta forma con una imagen proporcionada por un elemento BlobSource.

La imagen se recupera del BlobSource proporcionado una vez en el momento de la inserción 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 en formato PNG, JPEG o GIF.

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

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

Parámetros

Nombre	Tipo	Descripción
`blobSource`	`BlobSource`	Los datos de la imagen

Devolvedor

Image: El Image que reemplazó la forma.

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

`replaceWithImage(blobSource, crop)`

Reemplaza esta forma con una imagen proporcionada por un elemento BlobSource.

Cuando 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 en formato PNG, JPEG o GIF.

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the replaced image.
shape.replaceWithImage(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 de la forma existente. De lo contrario, la imagen se ajusta y se centra.

Devolvedor

Image: El Image que reemplazó la forma.

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

`replaceWithImage(imageUrl)`

Reemplaza esta forma por una imagen.

Cuando insertas la imagen, se recupera de la URL 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 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 Image.getSourceUrl().

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

Parámetros

Nombre	Tipo	Descripción
`imageUrl`	`String`	La URL de la imagen de la que se descargará.

Devolvedor

Image: El Image que reemplazó la forma.

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

`replaceWithImage(imageUrl, crop)`

Reemplaza esta forma por una imagen.

La URL proporcionada no debe superar los 2 KB. La URL en sí se guarda con la imagen y se expone a través de Image.getSourceUrl().

Parámetros

Nombre	Tipo	Descripción
`imageUrl`	`String`	La URL de la imagen de la que se descargará.
`crop`	`Boolean`	Si es `true`, recorta la imagen para adaptarla al tamaño de la forma existente. De lo contrario, la imagen se ajusta y se centra.

Devolvedor

Image: El Image que reemplazó la forma.

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

`replaceWithSheetsChart(sourceChart)`

Reemplaza esta forma por un gráfico de Hojas de cálculo de Google.

El gráfico está vinculado al gráfico de origen de Hojas de cálculo de Google que permite su actualización. Otros colaboradores pueden ver el vínculo a la hoja de cálculo fuente.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

Parámetros

Nombre	Tipo	Descripción
`sourceChart`	`EmbeddedChart`	Gráfico de una hoja de cálculo que reemplaza la forma.

Devolvedor

SheetsChart: Es el gráfico que reemplazó la forma.

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

`replaceWithSheetsChartAsImage(sourceChart)`

Reemplaza esta forma por una imagen de un gráfico de Hojas de cálculo de Google.

Para mantener la relación de aspecto del gráfico de Hojas de cálculo de Google, la imagen del gráfico se ajusta y se centra con respecto al tamaño de la forma existente.

La imagen del gráfico no está vinculada con el gráfico de origen de Hojas de cálculo de Google.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

Parámetros

Nombre	Tipo	Descripción
`sourceChart`	`EmbeddedChart`	Gráfico de una hoja de cálculo que reemplaza la forma.

Devolvedor

Image: Es la imagen del gráfico que reemplazó la forma.

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 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`	Proporción para ajustar la altura de este elemento de página.

Devolvedor

Shape: 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 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`	La proporción en la que se escala el ancho de este elemento de página.

Devolvedor

Shape: 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 el PageElement en la presentación activa y quita cualquier selección anterior. Esto es lo mismo que llamar a select(replace) con true.

Una secuencia de comandos solo puede acceder a la selección del usuario que la ejecuta y solo si esta 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 esta está vinculada a la presentación.

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

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

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

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 primero el Page superior usando Page.selectAsCurrentPage() y, luego, seleccionar los elementos de página en esa página.

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

Parámetros

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

Devolvedor

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

Devolvedor

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

`setContentAlignment(contentAlignment)`

Establece el ContentAlignment del texto en la forma.

Este método desactiva automáticamente las propiedades de ajuste automático de texto en las formas actualizadas.

Parámetros

Nombre	Tipo	Descripción
`contentAlignment`	`ContentAlignment`	Alineación que se establecerá.

Devolvedor

Shape: Esta forma, 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.

Devolvedor

Shape: 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 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`	La nueva altura del elemento de página que se va a establecer, en puntos.

Devolvedor

Shape: 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 página 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.

Devolvedor

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

Devolvedor

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

Devolvedor

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.

Devolvedor

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.

Devolvedor

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 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`	El nuevo ángulo de rotación en el sentido de las manecillas del reloj que se va a establecer, en grados.

Devolvedor

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

Devolvedor

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

Devolvedor

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

La actualización de 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; no afecta las transformaciones del grupo ni de otros elementos de la página del 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.

Devolvedor

Shape: 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 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`	El nuevo ancho del elemento de página que se establecerá, en puntos.

Devolvedor

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