Class Shape

Forma

Un 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étodoTipo de datos que se muestraDescripción breve
alignOnPage(alignmentPosition)ShapeAlinea el elemento con la posición de alineación especificada en la página.
bringForward()ShapeAdelanta el elemento de la página en un elemento.
bringToFront()ShapeLleva el elemento de la página al frente de la página.
duplicate()PageElementDuplica el elemento de la página.
getAutofit()Autofit|nullDevuelve el Autofit del texto dentro de esta forma.
getBorder()BorderDevuelve el Border de la forma.
getConnectionSites()ConnectionSite[]Devuelve la lista de ConnectionSites en el elemento de la página o una lista vacía si el elemento de la página no tiene ningún sitio de conexión.
getContentAlignment()ContentAlignmentDevuelve el ContentAlignment del texto en la forma.
getDescription()StringDevuelve la descripción del texto alternativo del elemento de la página.
getFill()FillDevuelve el Fill de la forma.
getHeight()Number|nullObtiene la altura del elemento en puntos, que es la altura del cuadro delimitador del elemento cuando este no tiene rotación.
getInherentHeight()Number|nullDevuelve la altura inherente del elemento en puntos.
getInherentWidth()Number|nullDevuelve el ancho inherente del elemento en puntos.
getLeft()NumberDevuelve 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|nullDevuelve Link o null si no hay ningún vínculo.
getObjectId()StringDevuelve el ID único de este objeto.
getPageElementType()PageElementTypeDevuelve el tipo del elemento de la página, representado como una enumeración PageElementType.
getParentGroup()Group|nullDevuelve el grupo al que pertenece este elemento de la página o null si el elemento no está en un grupo.
getParentPage()PageDevuelve la página en la que se encuentra este elemento de página.
getParentPlaceholder()PageElement|nullDevuelve el elemento de página principal del marcador de posición.
getPlaceholderIndex()Integer|nullDevuelve el índice del marcador de posición de la forma.
getPlaceholderType()PlaceholderTypeDevuelve el tipo de marcador de posición de la forma o PlaceholderType.NONE si la forma no es un marcador de posición.
getRotation()NumberDevuelve 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()ShapeTypeDevuelve el tipo de la forma.
getText()TextRangeDevuelve el contenido de texto de la forma.
getTitle()StringDevuelve el título del texto alternativo del elemento de la página.
getTop()NumberObtiene la posición vertical del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.
getTransform()AffineTransformDevuelve la transformación del elemento de la página.
getWidth()Number|nullDevuelve el ancho del elemento en puntos, que es el ancho del cuadro delimitador del elemento cuando este no tiene rotación.
preconcatenateTransform(transform)ShapeAntepone la transformación proporcionada a la transformación existente del elemento de la página.
remove()voidQuita el elemento de la página.
removeLink()voidQuita un Link.
replaceWithImage(blobSource)ImageReemplaza esta forma por una imagen proporcionada por un BlobSource.
replaceWithImage(blobSource, crop)ImageReemplaza esta forma por una imagen proporcionada por un BlobSource.
replaceWithImage(imageUrl)ImageReemplaza esta forma por una imagen.
replaceWithImage(imageUrl, crop)ImageReemplaza esta forma por una imagen.
replaceWithSheetsChart(sourceChart)SheetsChartReemplaza esta forma por un gráfico de Hojas de cálculo de Google.
replaceWithSheetsChartAsImage(sourceChart)ImageReemplaza esta forma por una imagen de un gráfico de Hojas de cálculo de Google.
scaleHeight(ratio)ShapeAjusta la altura del elemento según la proporción especificada.
scaleWidth(ratio)ShapeAjusta el ancho del elemento según la proporción especificada.
select()voidSelecciona solo el PageElement en la presentación activa y quita cualquier selección anterior.
select(replace)voidSelecciona el PageElement en la presentación activa.
sendBackward()ShapeEnvía el elemento de la página hacia atrás en la página en un elemento.
sendToBack()ShapeEnvía el elemento de la página al fondo de la página.
setContentAlignment(contentAlignment)ShapeEstablece el ContentAlignment del texto en la forma.
setDescription(description)ShapeEstablece la descripción del texto alternativo del elemento de la página.
setHeight(height)ShapeEstablece la altura del elemento en puntos, que es la altura del cuadro delimitador del elemento cuando este no tiene rotación.
setLeft(left)ShapeEstablece la posición horizontal del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.
setLinkSlide(slideIndex)LinkEstablece un objeto Link en el objeto Slide determinado con el índice basado en cero de la diapositiva.
setLinkSlide(slide)LinkEstablece un Link en el Slide determinado. El vínculo se establece con el ID de diapositiva determinado.
setLinkSlide(slidePosition)LinkEstablece un Link en el Slide determinado usando la posición relativa de la diapositiva.
setLinkUrl(url)LinkEstablece un Link en la cadena de URL no vacía proporcionada.
setRotation(angle)ShapeEstablece el ángulo de rotación del elemento en el sentido de las manecillas del reloj alrededor de su centro en grados.
setTitle(title)ShapeEstablece el título del texto alternativo del elemento de la página.
setTop(top)ShapeEstablece 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)ShapeEstablece la transformación del elemento de la página con la transformación proporcionada.
setWidth(width)ShapeEstablece el ancho del elemento en puntos, que es el ancho del cuadro delimitador 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

NombreTipoDescripción
alignmentPositionAlignmentPositionPosición en la que se alineará este elemento de la página.

Volver

Shape: Este elemento de la página, para encadenar.

bringForward()

Adelanta el elemento de la página en un elemento.

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

Volver

Shape: Este elemento de la página, para encadenar.

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

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

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

Volver

Shape: Este elemento de la página, para encadenar.

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 la página duplicada se coloca en la misma página y en la misma posición que el original.

Volver

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

Autorización

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

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

getAutofit()

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

Volver

Autofit|null: 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()

Devuelve el Border de la forma.

Volver

Border: Es el parámetro de configuración del 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()

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

Volver

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

Autorización

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

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

getContentAlignment()

Devuelve el ContentAlignment del texto en la forma.

Volver

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

Devuelve la descripción del texto alternativo del elemento de la 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 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

getFill()

Devuelve el Fill de la forma.

Volver

Fill: Es el parámetro de 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 delimitador 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 la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.

Volver

Number|null: Es la altura inherente del elemento de la página en puntos o null si el elemento de la página no tiene 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()

Devuelve la altura inherente del elemento en puntos.

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

Volver

Number|null: Es la altura inherente del elemento de la página en puntos o null si el elemento de la página no tiene 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()

Devuelve el ancho inherente del elemento en puntos.

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

Volver

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

Autorización

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

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

getLeft()

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

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

Devuelve Link o null si no hay ningún vínculo. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

Volver

Link|null: Es el Link o null si no hay un vínculo.

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

Devuelve el ID único de este objeto. Los IDs de objetos 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 alcances:

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

getPageElementType()

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

Volver

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

Autorización

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

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

getParentGroup()

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

Volver

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

Autorización

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

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

getParentPage()

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

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

getParentPlaceholder()

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

Volver

PageElement|null: Es el elemento de página principal de este marcador de posición de forma o null si esta forma no es un marcador de posición o no tiene un elemento principal.

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

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

Volver

Integer|null: Es el índice del marcador de posición de esta forma o 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()

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

Volver

PlaceholderType: Es el tipo de marcador de posición de esta 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()

Devuelve 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 (inclusive) y 360 (exclusive).

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

Devuelve el tipo de la forma.

Volver

ShapeType: Es el tipo de esta forma.

getText()

Devuelve el contenido de texto de la forma.

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

Volver

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

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

Volver

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

Autorización

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

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

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: Posición vertical de este elemento en puntos, desde la esquina superior izquierda de la página.

Autorización

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

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

getTransform()

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

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

Volver

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

Autorización

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

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

getWidth()

Devuelve el ancho del elemento en puntos, que es el ancho del cuadro delimitador 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 la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.

Volver

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

Autorización

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform;

Por ejemplo, para mover un elemento de la 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 la página por setTransform(transform).

Parámetros

NombreTipoDescripción
transformAffineTransformEs la transformación que se debe concatenar previamente a la transformación de este elemento de la página.

Volver

Shape: Este elemento de la página, para encadenar.

Autorización

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

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

remove()

Quita el elemento de la página.

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

Si se quita un marcador de posición PageElement en un diseño o en un elemento principal, también se quitarán los marcadores de posición vacíos que heredan.

Autorización

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

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

Quita un Link. 

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

replaceWithImage(blobSource)

Reemplaza esta forma por una imagen proporcionada por un 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 pesar menos de 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 centra con respecto al tamaño de la forma existente. 

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

Parámetros

NombreTipoDescripción
blobSourceBlobSourceSon los datos de la imagen.

Volver

Image: Es 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 por una imagen proporcionada por un BlobSource.

Cuando insertas la imagen, se recupera del BlobSource una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben pesar menos de 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

Parámetros

NombreTipoDescripción
blobSourceBlobSourceSon los datos de la imagen.
cropBooleanSi es true, recorta la imagen para que se ajuste al tamaño de la forma existente. De lo contrario, la imagen se ajusta y centra.

Volver

Image: Es 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 se inserta 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 pesar menos de 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 en sí 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 centra con respecto al tamaño de la forma existente.

Parámetros

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

Volver

Image: Es 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.

Cuando se inserta 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 pesar menos de 50 MB, no pueden superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.

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

NombreTipoDescripción
imageUrlStringEs la URL de la imagen desde la que se descargará.
cropBooleanSi es true, recorta la imagen para que se ajuste al tamaño de la forma existente. De lo contrario, la imagen se ajusta y centra.

Volver

Image: Es 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 con el gráfico fuente de Hojas de cálculo de Google, lo que permite que se actualice. Otros colaboradores pueden ver el vínculo a la hoja de cálculo fuente. 

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

Parámetros

NombreTipoDescripción
sourceChartEmbeddedChartEs el gráfico de una hoja de cálculo que reemplaza la forma.

Volver

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 centra con respecto al tamaño de la forma existente.

La imagen del gráfico no está vinculada al gráfico fuente de Hojas de cálculo de Google. 

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

Parámetros

NombreTipoDescripción
sourceChartEmbeddedChartEs el gráfico de una hoja de cálculo que reemplaza la forma.

Volver

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 de su cuadro delimitador cuando el elemento no tiene rotación.

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

Parámetros

NombreTipoDescripción
ratioNumberEs la proporción según la cual se debe ajustar la altura de este elemento de la página.

Volver

Shape: Este elemento de la página, para encadenar.

Autorización

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

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

scaleWidth(ratio)

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

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

Parámetros

NombreTipoDescripción
ratioNumberEs la proporción según la cual se debe ajustar el ancho de este elemento de la página.

Volver

Shape: Este elemento de la página, para encadenar.

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 está vinculada a la presentación.

Esto establece el Page principal del PageElement como el 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 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 está vinculada a la presentación.

Pasa true a este método para seleccionar solo el PageElement y quitar cualquier selección anterior. Esto también establece el Page principal del PageElement como el 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 la página con un parámetro false:

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

Para asegurarte de que sea así, el enfoque preferido es seleccionar primero el Page principal con Page.selectAsCurrentPage() y, luego, seleccionar los elementos de la 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

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

Autorización

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

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

sendBackward()

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

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

Volver

Shape: Este elemento de la página, para encadenar.

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 la página al fondo de la página.

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

Volver

Shape: Este elemento de la página, para encadenar.

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

NombreTipoDescripción
contentAlignmentContentAlignmentEs la alineación que se establecerá.

Volver

Shape: Esta forma, para encadenar.

Autorización

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

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

setDescription(description)

Establece la descripción del texto alternativo del elemento de la 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

NombreTipoDescripción
descriptionStringEs la cadena para establecer la descripción del texto alternativo.

Volver

Shape: Es este elemento de la página.

Autorización

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

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

setHeight(height)

Establece la altura del elemento en puntos, que es la altura del cuadro delimitador 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 la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.

Parámetros

NombreTipoDescripción
heightNumberEs la nueva altura que se establecerá para este elemento de la página, en puntos.

Volver

Shape: Este elemento de la página, para encadenar.

Autorización

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

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

setLeft(left)

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

Parámetros

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

Volver

Shape: Este elemento de la página, para encadenar.

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 objeto Link en el objeto Slide determinado con el índice basado en cero de la diapositiva. 

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

Parámetros

NombreTipoDescripción
slideIndexIntegerÍndice basado en cero de la diapositiva.

Volver

Link: Es el Link que se configuró.

Autorización

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

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

setLinkSlide(slide)

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

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

Parámetros

NombreTipoDescripción
slideSlideEs el Slide que se vinculará.

Volver

Link: Es el Link que se configuró.

Autorización

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

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

setLinkSlide(slidePosition)

Establece un Link en el Slide determinado usando la posición relativa de la diapositiva. 

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

Parámetros

NombreTipoDescripción
slidePositionSlidePositionEs el SlidePosition relativo.

Volver

Link: Es el Link que se configuró.

Autorización

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

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

setLinkUrl(url)

Establece un Link en la cadena de URL no vacía proporcionada. 

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

Parámetros

NombreTipoDescripción
urlStringEs la cadena de URL.

Volver

Link: Es el Link que se configuró.

Autorización

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

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

setRotation(angle)

Establece el ángulo de rotación del elemento en 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 la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.

Parámetros

NombreTipoDescripción
angleNumberEs el nuevo ángulo de rotación en el sentido de las manecillas del reloj que se configurará, en grados.

Volver

Shape: Este elemento de la página, para encadenar.

Autorización

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

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

setTitle(title)

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

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

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

Parámetros

NombreTipoDescripción
titleStringEs la cadena que se usará para establecer el título del texto alternativo.

Volver

Shape: Es este elemento de la página.

Autorización

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

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

setTop(top)

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

Parámetros

NombreTipoDescripción
topNumberNueva posición vertical que se establecerá, en puntos.

Volver

Shape: Este elemento de la página, para encadenar.

Autorización

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

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

setTransform(transform)

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

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

Cuando se actualiza la transformación de un elemento de la página que se encuentra en un grupo, solo se cambia la transformación de ese elemento de la página, y no se afectan las transformaciones del grupo ni de otros elementos de la página que se encuentren en el grupo.

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

Parámetros

NombreTipoDescripción
transformAffineTransformEs la transformación que se establece para este elemento de la página.

Volver

Shape: Este elemento, para encadenar.

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 delimitador 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 la página no son compatibles con este método, consulta las limitaciones de tamaño y posición.

Parámetros

NombreTipoDescripción
widthNumberNuevo ancho de este elemento de la página que se establecerá, en puntos.

Volver

Shape: Este elemento de la página, para encadenar.

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