Representa una imagen sobre la cuadrícula en una hoja de cálculo.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
assignScript(functionName) | OverGridImage | Asigna a esta imagen la función con el nombre de la función especificado. |
getAltTextDescription() | String | Muestra la descripción de texto alternativo de esta imagen. |
getAltTextTitle() | String | Muestra el título de texto alternativo de esta imagen. |
getAnchorCell() | Range | Muestra la celda en la que se ancla una imagen. |
getAnchorCellXOffset() | Integer | Muestra el desplazamiento de píxeles horizontales desde la celda de anclaje. |
getAnchorCellYOffset() | Integer | Muestra el desplazamiento de píxeles verticales desde la celda de anclaje. |
getHeight() | Integer | Muestra la altura real de esta imagen en píxeles. |
getInherentHeight() | Integer | Muestra la altura inherente de esta imagen en píxeles. |
getInherentWidth() | Integer | Muestra la altura inherente de esta imagen en píxeles. |
getScript() | String | Muestra el nombre de la función asignada a esta imagen. |
getSheet() | Sheet | Muestra la hoja en la que aparece esta imagen. |
getUrl() | String | Obtiene la URL de origen de la imagen y muestra null si la URL no está disponible. |
getWidth() | Integer | Muestra el ancho real de esta imagen en píxeles. |
remove() | void | Borra esta imagen de la hoja de cálculo. |
replace(blob) | OverGridImage | Reemplaza esta imagen por la que especifica el BlobSource proporcionado. |
replace(url) | OverGridImage | Reemplaza esta imagen por la de la URL especificada. |
resetSize() | OverGridImage | Restablece esta imagen a sus dimensiones inherentes. |
setAltTextDescription(description) | OverGridImage | Establece la descripción del texto alternativo de esta imagen. |
setAltTextTitle(title) | OverGridImage | Establece el título de texto alternativo para esta imagen. |
setAnchorCell(cell) | OverGridImage | Establece la celda en la que se ancla una imagen. |
setAnchorCellXOffset(offset) | OverGridImage | Establece el desplazamiento de píxeles horizontales respecto de la celda de anclaje. |
setAnchorCellYOffset(offset) | OverGridImage | Establece el desplazamiento del píxel vertical desde la celda de anclaje. |
setHeight(height) | OverGridImage | Establece la altura real de esta imagen en píxeles. |
setWidth(width) | OverGridImage | Establece el ancho real de esta imagen en píxeles. |
Documentación detallada
assignScript(functionName)
Asigna a esta imagen la función con el nombre de la función especificado.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
functionName | String | El nombre de la función que se especifica. Debe ser una función pública de nivel superior, no una que termine en un guion bajo como privateFunction_ . |
Devolvedor
OverGridImage
: Esta imagen es para 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAltTextDescription()
Muestra la descripción de texto alternativo de esta imagen.
Devolvedor
String
: Es la descripción del texto alternativo.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
Muestra el título de texto alternativo de esta imagen.
Devolvedor
String
: Es el título del texto alternativo.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCell()
Muestra la celda en la que se ancla una imagen.
Devolvedor
Range
: Es la celda de anclaje.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCellXOffset()
Muestra el desplazamiento de píxeles horizontales desde la celda de anclaje.
Devolvedor
Integer
: Indica el desplazamiento de píxeles horizontales.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCellYOffset()
Muestra el desplazamiento de píxeles verticales desde la celda de anclaje.
Devolvedor
Integer
: Indica el desplazamiento del píxel vertical.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
Muestra la altura real de esta imagen en píxeles.
// Logs the height of all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getHeight()); }
Devolvedor
Integer
: Es la altura de la imagen en píxeles.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getInherentHeight()
Muestra la altura inherente de esta imagen en píxeles.
Devolvedor
Integer
: Es la altura inherente en píxeles.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getInherentWidth()
Muestra la altura inherente de esta imagen en píxeles.
Devolvedor
Integer
: Es el ancho inherente en píxeles.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getScript()
Muestra el nombre de la función asignada a esta imagen.
Devolvedor
String
: Es el nombre de la funció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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheet()
Muestra la hoja en la que aparece esta imagen.
// Logs the parent sheet of all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getSheet()); }
Devolvedor
Sheet
: Es la hoja en la que aparece la imagen.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getUrl()
Obtiene la URL de origen de la imagen y muestra null
si la URL no está disponible. Si la imagen se insertó mediante una API con una API, este método muestra la URL proporcionada durante la inserción de la imagen.
Devolvedor
String
: Es la URL de la imagen, si está disponible. Muestra null
si la imagen no está disponible o no tiene una URL de origen.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
Muestra el ancho real de esta imagen en píxeles.
// Logs the width of all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getWidth()); }
Devolvedor
Integer
: Es el ancho de la imagen en píxeles.
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Borra esta imagen de la hoja de cálculo. Cualquier operación adicional en la imagen generará un error de secuencia de comandos.
// Deletes all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { images[i].remove(); }
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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace(blob)
Reemplaza esta imagen por la que especifica el BlobSource
proporcionado. El tamaño máximo permitido para un BLOB es 2 MB.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
blob | BlobSource | La imagen nueva como un BLOB. |
Devolvedor
OverGridImage
: Esta imagen es para 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace(url)
Reemplaza esta imagen por la de la URL especificada.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
url | String | La URL de la imagen nueva. |
Devolvedor
OverGridImage
: Esta imagen es para 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
resetSize()
Restablece esta imagen a sus dimensiones inherentes.
Devolvedor
OverGridImage
: Esta imagen es para 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextDescription(description)
Establece la descripción del texto alternativo de esta imagen.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
description | String | La nueva descripción de texto alternativo de la imagen. |
Devolvedor
OverGridImage
: Esta imagen es para 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextTitle(title)
Establece el título de texto alternativo para esta imagen.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
title | String | Es el nuevo título de texto alternativo para la imagen. |
Devolvedor
OverGridImage
: Esta imagen es para 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCell(cell)
Establece la celda en la que se ancla una imagen.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
cell | Range | La nueva celda de anclaje. |
Devolvedor
OverGridImage
: Esta imagen es para 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCellXOffset(offset)
Establece el desplazamiento de píxeles horizontales respecto de la celda de anclaje.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El nuevo desplazamiento horizontal de píxeles. |
Devolvedor
OverGridImage
: Esta imagen es para 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCellYOffset(offset)
Establece el desplazamiento del píxel vertical desde la celda de anclaje.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
offset | Integer | El nuevo desplazamiento de píxeles vertical. |
Devolvedor
OverGridImage
: Esta imagen es para 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHeight(height)
Establece la altura real de esta imagen en píxeles.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
height | Integer | La altura deseada en píxeles. |
Devolvedor
OverGridImage
: Es la imagen del 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWidth(width)
Establece el ancho real de esta imagen en píxeles.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
width | Integer | El ancho deseado en píxeles. |
Devolvedor
OverGridImage
: Es la imagen del 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/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets