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 especificada en la página. |
bringForward() | Shape | Mueve el elemento de página hacia adelante en la página un elemento. |
bringToFront() | Shape | Mueve el elemento de página al frente de la página. |
duplicate() | PageElement | Duplica el elemento de 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 la página, o una lista vacía si el elemento de la 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 el elemento no tiene rotación. |
getInherentHeight() | Number | Muestra la altura inherente del elemento en puntos. |
getInherentWidth() | Number | Muestra el ancho inherente del elemento en puntos. |
getLeft() | Number | 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 la 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. |
getParentPlaceholder() | PageElement | Muestra el elemento de página principal 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 sentido horario alrededor del 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 la 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 la 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 | Concatena la transformación proporcionada a la transformación existente del elemento de la página. |
remove() | void | Quita el elemento de la página. |
removeLink() | void | Quita un Link . |
replaceWithImage(blobSource) | Image | Reemplaza esta forma por una imagen proporcionada por un BlobSource . |
replaceWithImage(blobSource, crop) | Image | Reemplaza esta forma por una imagen proporcionada por un 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 el elemento de página hacia atrás en la página por un elemento. |
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 del 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 el elemento 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 para la Slide determinada mediante el índice basado en cero de la diapositiva. |
setLinkSlide(slide) | Link | Establece un Link en la Slide determinada. El vínculo se establece en el ID de la diapositiva determinada. |
setLinkSlide(slidePosition) | Link | Establece un Link para la Slide determinada usando la posición relativa de la diapositiva. |
setLinkUrl(url) | Link | Establece un Link para la string de URL no vacía especificada. |
setRotation(angle) | Shape | Establece el ángulo de rotación del elemento en sentido horario alrededor del centro en grados. |
setTitle(title) | Shape | Establece el título del texto alternativo del elemento de la 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 la 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 el elemento no tiene rotación. |
Documentación detallada
alignOnPage(alignmentPosition)
Alinea el elemento con la posición especificada en la página.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
alignmentPosition | AlignmentPosition | Es la posición con la que se alinea este elemento de la página. |
Volver
Shape
: Es el elemento de esta página, para el encadenamiento.
bringForward()
Mueve el elemento de página hacia adelante en la página un elemento.
El elemento de la página no debe estar en un grupo.
Volver
Shape
: Es el elemento de esta 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()
Mueve el elemento de página al frente de la página.
El elemento de la página no debe estar en un grupo.
Volver
Shape
: Es el elemento de esta 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 página.
El elemento de página duplicado se coloca en la misma página en la misma posición que el original.
Volver
PageElement
: Es el nuevo duplicado de este elemento de página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAutofit()
Muestra el Autofit
del texto dentro de esta forma. Este valor es null
si la forma no permite texto.
Volver
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.
Volver
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 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()
Muestra 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()
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 el texto alternativo.
Volver
String
: Es la descripción de 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()
Muestra el Fill
de la forma.
Volver
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 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.
Volver
Number
: Corresponde a la altura inherente del elemento de página en puntos, o null
si el elemento de página no tiene una altura.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes 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 está relacionada con su tamaño inherente. Usa el tamaño inherente junto con la transformación del elemento para determinar la apariencia visual final del elemento.
Volver
Number
: Corresponde a la altura inherente del elemento de página en puntos, o null
si el elemento de página no tiene una altura.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes 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 está relacionada con su tamaño inherente. Usa el tamaño inherente junto con la transformación del elemento para determinar la apariencia visual final del elemento.
Volver
Number
: Es el ancho inherente del elemento de página en puntos, o null
si el elemento de página no tiene un ancho.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes 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.
Volver
Number
: Es la posición horizonal 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
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()); }
Volver
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.
Volver
String
: el ID único de este objeto.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
Muestra el tipo de elemento de página, representado como una enumeración PageElementType
.
Volver
PageElementType
: Es el tipo de elemento de 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 la página, o null
si el elemento no está en un grupo.
Volver
Group
: 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()
Muestra la página en la que se encuentra este elemento.
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()
Muestra el elemento de 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.
Volver
PageElement
: Es el elemento de la 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()
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.
Volver
Integer
: Es el marcador de posición del índice 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()
Muestra 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()
Muestra el ángulo de rotación del elemento en sentido horario alrededor del 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 (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()
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.
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()
Muestra el título de 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 de texto alternativo del elemento de página.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
Obtiene la posición vertical del elemento en puntos, medida desde la esquina superior izquierda de la página cuando el elemento no tiene rotación.
Volver
Number
: Es la posición vertical 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 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 la transformación de un elemento de página con las transformaciones de todos sus grupos superiores. Si el elemento de la página no está en un grupo, su transformación absoluta es la misma que el valor en 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()
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 la página no son compatibles con este método, consulta las limitaciones de tamaño y posicionamiento.
Volver
Number
: Es el ancho inherente del elemento de página en puntos, o null
si el elemento de página no tiene un ancho.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
Concatena 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 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 la página por setTransform(transform)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
transform | AffineTransform | La transformación que se preubicará en la transformación de este elemento de la página. |
Volver
Shape
: Es el elemento de esta 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 la página.
Si, después de una operación de eliminación, un objeto Group
contiene solo uno o ningún elemento de la página, también se quita el grupo.
Si se quita un marcador de posición PageElement
en una instancia principal o un diseño, también se quitan los marcadores de posición heredados heredados.
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 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 mostrar dentro de la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no deben superar los 25 megapíxeles y deben estar en formato PNG, JPEG o GIF.
A fin de 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. |
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
.
Al insertar la imagen, se recupera de la BlobSource
una vez y se almacena una copia para mostrar dentro de la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no deben 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 , se recorta la imagen para adaptarla al tamaño de la forma existente. De lo contrario, la imagen se escala y se 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.
Al insertar la imagen, se recupera de la URL una vez y se almacena una copia para mostrar en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no deben 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 mediante Image.getSourceUrl()
.
A fin de 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 desde donde 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.
Al insertar la imagen, se recupera de la URL una vez y se almacena una copia para mostrar en la presentación. Las imágenes deben tener un tamaño inferior a 50 MB, no deben 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
Nombre | Tipo | Descripción |
---|---|---|
imageUrl | String | La URL de la imagen desde donde se descargará. |
crop | Boolean | Si es true , se recorta la imagen para adaptarla al tamaño de la forma existente. De lo contrario, la imagen se escala y se 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 al gráfico de Hojas de cálculo de Google de origen que permite que se actualice. 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
Nombre | Tipo | Descripción |
---|---|---|
sourceChart | EmbeddedChart | El gráfico en 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 proporción del gráfico de Hojas de cálculo de Google, la imagen del gráfico se escala y se centra con respecto al tamaño de la forma existente.
La imagen del gráfico no está vinculada al gráfico de Hojas de cálculo de Google de origen.
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 | El gráfico en 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 altura del 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
Nombre | Tipo | Descripción |
---|---|---|
ratio | Number | Proporción para ajustar la altura de este elemento de página. |
Volver
Shape
: Es el elemento de esta 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 del 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
Nombre | Tipo | Descripción |
---|---|---|
ratio | Number | Proporción para ajustar el ancho de este elemento de página. |
Volver
Shape
: Es el elemento de esta 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 ejecuta la secuencia de comandos y solo si la secuencia está vinculada a la presentación.
Esto establece el Page
superior 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 ejecuta la secuencia de comandos y solo si la secuencia 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
.
Se deben cumplir las siguientes condiciones cuando se selecciona un elemento de página mediante un parámetro false
:
- El
Page
superior del objetoPageElement
debe sercurrent page selection
. - No debe haber varios objetos
Page
seleccionados.
Para asegurarte de que ese sea el enfoque preferido, primero selecciona el elemento Page
principal con Page.selectAsCurrentPage()
y, luego, los elementos 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
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 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.
Volver
Shape
: Es el elemento de esta 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 la página no debe estar en un grupo.
Volver
Shape
: Es el elemento de esta 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 | La alineación que se establecerá. |
Volver
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 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
Nombre | Tipo | Descripción |
---|---|---|
description | String | Cadena en la que se va a establecer la descripción de texto alternativo |
Volver
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 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 la 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 de este elemento de la página, en puntos. |
Volver
Shape
: Es el elemento de esta 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 establecerá, en puntos. |
Volver
Shape
: Es el elemento de esta 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
para la Slide
determinada mediante 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 | Es el índice basado en cero de la diapositiva. |
Volver
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
en la Slide
determinada. El vínculo se establece en el ID de la diapositiva determinada.
// 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á. |
Volver
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 Link
para la Slide
determinada 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 | El SlidePosition relativo. |
Volver
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)
Establece un Link
para la string de URL no vacía especificada.
// Set a link to the URL. shape.setLinkUrl("https://slides.google.com");
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
url | String | La string de la URL. |
Volver
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)
Establece el ángulo de rotación del elemento en sentido horario 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
Nombre | Tipo | Descripción |
---|---|---|
angle | Number | El nuevo ángulo de rotación en el sentido de las manecillas del reloj para establecerlo, en grados. |
Volver
Shape
: Es el elemento de esta 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 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". 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 debe configurar el título del texto alternativo |
Volver
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, 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 configurará, en puntos. |
Volver
Shape
: Es el elemento de esta 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 la 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 cambiar su apariencia visual.
Actualizar la transformación de un elemento de página que está en un grupo solo cambia la transformación de ese elemento de la página; no afecta las transformaciones del grupo ni otros elementos de página del grupo.
Para obtener detalles sobre cómo las transformaciones afectan la apariencia visual de los elementos de la página, consulta getTransform()
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
transform | AffineTransform | La transformación que se configura para este elemento de página. |
Volver
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 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
Nombre | Tipo | Descripción |
---|---|---|
width | Number | Es el nuevo ancho de este elemento de página, establecido en puntos. |
Volver
Shape
: Es el elemento de esta 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