Class Shape

Forma

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é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()ShapeHace que el elemento de página avance en la página de a un elemento.
bringToFront()ShapeUbica el elemento de página al principio de la página.
duplicate()PageElementDuplica el elemento de página.
getAutofit()AutofitMuestra el Autofit del texto dentro de esta forma.
getBorder()BorderMuestra el Border de la forma.
getConnectionSites()ConnectionSite[]Muestra la lista de ConnectionSite 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()ContentAlignmentMuestra el ContentAlignment del texto en la forma.
getDescription()StringMuestra la descripción del texto alternativo del elemento de página.
getFill()FillMuestra el Fill de la forma.
getHeight()NumberObtiene la altura del elemento en puntos, que es la altura del cuadro delimitador del elemento cuando el elemento no tiene rotación.
getInherentHeight()NumberMuestra la altura inherente del elemento en puntos.
getInherentWidth()NumberMuestra el ancho inherente del elemento en puntos.
getLeft()NumberMuestra 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()LinkMuestra Link o null si no hay un vínculo.
getObjectId()StringMuestra el ID único de este objeto.
getPageElementType()PageElementTypeMuestra el tipo de elemento de página, representado como una enumeración PageElementType.
getParentGroup()GroupMuestra el grupo al que pertenece este elemento de página o null si el elemento no está en un grupo.
getParentPage()PageMuestra la página en la que se encuentra este elemento de página.
getParentPlaceholder()PageElementMuestra el elemento de la página principal del marcador de posición.
getPlaceholderIndex()IntegerMuestra el índice de marcador de posición de la forma.
getPlaceholderType()PlaceholderTypeMuestra el tipo de marcador de posición de la forma o PlaceholderType.NONE si la forma no es un marcador de posición.
getRotation()NumberMuestra el ángulo de rotación en el sentido de las manecillas del reloj alrededor de su centro en grados, donde cero grados significa que no hay rotación.
getShapeType()ShapeTypeMuestra el tipo de forma.
getText()TextRangeMuestra el contenido de texto de la forma.
getTitle()StringMuestra el título de texto alternativo del elemento de 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()AffineTransformMuestra la transformación del elemento de página.
getWidth()NumberMuestra el ancho del elemento en puntos, que es el ancho del cuadro de límite del elemento cuando este no tiene rotación.
preconcatenateTransform(transform)ShapePreconcatena la transformación proporcionada en la transformación existente del elemento de 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)ShapeEscala la altura del elemento según la proporción especificada.
scaleWidth(ratio)ShapeEscala el ancho del elemento según la proporción especificada.
select()voidSelecciona solo la PageElement en la presentación activa y quita la selección anterior.
select(replace)voidSelecciona el PageElement en la presentación activa.
sendBackward()ShapeEnvía el elemento de página hacia atrás en la página por un elemento.
sendToBack()ShapeEnvía el elemento de página a la parte posterior 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 página.
setHeight(height)ShapeEstablece la altura del elemento en puntos, que es la altura del cuadro delimitador del elemento cuando el elemento no tiene rotación.
setLeft(left)ShapeEstablece la posición horizontal del elemento en puntos, que se mide desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.
setLinkSlide(slideIndex)LinkEstablece un elemento Link en el 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 mediante el ID de diapositiva especificado.
setLinkSlide(slidePosition)LinkEstablece un elemento Link en el Slide determinado utilizando la posición relativa de la diapositiva.
setLinkUrl(url)LinkEstablece una Link en la string de URL especificada que no está vacía.
setRotation(angle)ShapeEstablece el ángulo de rotación en el sentido de las manecillas del reloj alrededor del centro en grados.
setTitle(title)ShapeEstablece el título del texto alternativo del elemento de página.
setTop(top)ShapeEstablece la posición vertical del elemento en puntos, que se mide desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.
setTransform(transform)ShapeConfigura la transformación del elemento de 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
alignmentPositionAlignmentPositionLa posición en la que se alinea este elemento de página en la página.

Devolvedor

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


bringForward()

Hace que el elemento de página avance en la página de a un elemento.

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

Devolvedor

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

Autorización

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

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

bringToFront()

Ubica el elemento de página al principio de la página.

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

Devolvedor

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

Autorización

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

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

duplicate()

Duplica el elemento de página.

El elemento de página duplicado se coloca en la misma página 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 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()

Muestra la lista de ConnectionSite 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.

Devolvedor

ConnectionSite[]: Indica la lista de sitios de conexión, que puede estar vacía si el 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 del 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 del texto alternativo del elemento de página.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes 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 delimitador del elemento cuando el elemento no tiene rotación.

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

Devolvedor

Number: La altura inherente del elemento de página en puntos, o bien null si el elemento de 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()

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: La altura inherente del elemento de página en puntos, o bien null si el elemento de 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()

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 junto con la transformación del elemento para determinar la apariencia visual final del elemento.

Devolvedor

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

Autorización

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

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

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 ID de objeto que usan las páginas y los elementos de página comparten el mismo espacio de nombres.

Devolvedor

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

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

Devolvedor

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

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 principal 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 la página superior de este marcador de posición de forma, o bien null si esta 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 dos o más instancias del mismo tipo de marcador de posición están presentes en la misma página, cada una tiene su propio valor de índice único. Muestra null si la forma no es un marcador de posición.

Devolvedor

Integer: Indica el índice del marcador de posición de esta forma, o bien null si 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 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 (excluido).

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 del texto alternativo del elemento de página.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes 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 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()

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

La transformación absoluta determina la apariencia visual del elemento de página. Para calcular la transformación absoluta, concatena previamente 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 en este campo.

Devolvedor

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

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

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

Devolvedor

Number: 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 los elementos de una página 36 puntos hacia la izquierda:

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

NombreTipoDescripción
transformAffineTransformLa transformación que se preconcatenará en la transformación de este elemento de página.

Devolvedor

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

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes 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, una Group contiene solo uno o ningún elemento de página, también se quita el grupo.

Si se quita un marcador de posición PageElement de un diseño principal o de un diseño, también se quitan los marcadores de posición heredados vacíos.

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.

shape.removeLink();

replaceWithImage(blobSource)

Reemplaza esta forma por una imagen proporcionada por un BlobSource.

La imagen se recupera de la BlobSource proporcionada 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

NombreTipoDescripción
blobSourceBlobSourceLos datos de la imagen

Devolvedor

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 se inserta la imagen, se obtiene de BlobSource una vez y se almacena una copia para mostrarla en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no pueden superar los 25 megapíxeles y 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

NombreTipoDescripción
blobSourceBlobSourceLos datos de la imagen
cropBooleanSi 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: 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 obtiene 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

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

Devolvedor

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 obtiene 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 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
imageUrlStringLa URL de la imagen desde la que se descargará la imagen.
cropBooleanSi 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: 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 de origen de Hojas de cálculo de Google que permite actualizarlo. Otros colaboradores pueden ver el vínculo a la hoja de cálculo de origen.

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

NombreTipoDescripción
sourceChartEmbeddedChartEl 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

NombreTipoDescripción
sourceChartEmbeddedChartEl 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)

Escala la altura del elemento según la proporción especificada. La altura del elemento es la altura de su cuadro de límite cuando el elemento no tiene rotación.

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

Parámetros

NombreTipoDescripción
ratioNumberLa proporción en la que se debe escalar la altura de este elemento de página.

Devolvedor

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

Autorización

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

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

scaleWidth(ratio)

Escala el ancho del elemento según la proporción especificada. El ancho del elemento es el ancho de su cuadro de límite cuando el elemento no tiene rotación.

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

Parámetros

NombreTipoDescripción
ratioNumberLa proporción en la que se debe escalar el ancho de este elemento de página.

Devolvedor

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

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes 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 la 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 Page superior de PageElement como current page selection.

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

Cuando se selecciona un elemento de página mediante un parámetro false, se deben cumplir las siguientes condiciones:

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

Para asegurarte de que ese sea el caso, el enfoque preferido es seleccionar el Page superior primero con Page.selectAsCurrentPage() y, luego, seleccionar los elementos de página dentro de 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

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 página hacia atrás en la página por un elemento.

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

Devolvedor

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

Autorización

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

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

sendToBack()

Envía el elemento de página a la parte posterior de la página.

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

Devolvedor

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

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes 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
contentAlignmentContentAlignmentLa alineación que se establecerá.

Devolvedor

Shape: Esta forma sirve 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 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".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parámetros

NombreTipoDescripción
descriptionStringCadena en la que se va a establecer la descripción de texto alternativo.

Devolvedor

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

Parámetros

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

Devolvedor

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

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes 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, que se mide desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.

Parámetros

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

Devolvedor

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

Autorización

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

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

setLinkSlide(slideIndex)

Establece un elemento 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

NombreTipoDescripción
slideIndexIntegerEl índice basado en cero de la diapositiva.

Devolvedor

Link: 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 mediante el ID de diapositiva especificado.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Parámetros

NombreTipoDescripción
slideSlideEl Slide que se vinculará.

Devolvedor

Link: 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 elemento Link en el Slide determinado utilizando 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

NombreTipoDescripción
slidePositionSlidePositionEl SlidePosition relativo

Devolvedor

Link: 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 una Link en la string de URL especificada que no está vacía.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Parámetros

NombreTipoDescripción
urlStringEs la string de la URL.

Devolvedor

Link: 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 en el sentido de las manecillas del reloj alrededor del 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 posicionamiento.

Parámetros

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

Devolvedor

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

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes 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 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".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parámetros

NombreTipoDescripción
titleStringCadena en la que se va a establecer el título de texto alternativo.

Devolvedor

Shape: 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, que se mide desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.

Parámetros

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

Devolvedor

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

Autorización

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

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

setTransform(transform)

Configura 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 de ese grupo, lo que puede modificar 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; no afecta las transformaciones del grupo ni de otros elementos de página del grupo.

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

Parámetros

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

Devolvedor

Shape: Este elemento se usa para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes 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 posicionamiento.

Parámetros

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

Devolvedor

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

Autorización

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

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