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

Class Drawing

Representa un dibujo sobre una hoja de una hoja de cálculo.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`getContainerInfo()`	`ContainerInfo`	Obtiene información sobre dónde se ubica el dibujo en la hoja.
`getHeight()`	`Integer`	Muestra la altura real de este dibujo en píxeles.
`getOnAction()`	`String`	Muestra el nombre de la macro adjunta a este dibujo.
`getSheet()`	`Sheet`	Muestra la hoja en la que aparece este dibujo.
`getWidth()`	`Integer`	Muestra el ancho real de este dibujo en píxeles.
`getZIndex()`	`Number`	Muestra el índice z de este dibujo.
`remove()`	`void`	Borra este dibujo de la hoja de cálculo.
`setHeight(height)`	`Drawing`	Establece la altura real de este dibujo en píxeles.
`setOnAction(macroName)`	`Drawing`	Asigna una función de macro a este dibujo.
`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`	`Drawing`	Establece la posición en la que aparece el dibujo en la hoja.
`setWidth(width)`	`Drawing`	Establece el ancho real de este dibujo en píxeles.
`setZIndex(zIndex)`	`Drawing`	Establece el índice z de este dibujo.

Documentación detallada

`getContainerInfo()`

Obtiene información sobre dónde se ubica el dibujo en la hoja.

Volver

ContainerInfo: Es un objeto que contiene la posición del contenedor del dibujo.

Autorización

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

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

`getHeight()`

Muestra la altura real de este dibujo en píxeles.

// Logs the height of all drawings in a sheet
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getHeight());
}

Volver

Integer: Es la altura del dibujo 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 ámbitos:

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

`getOnAction()`

Muestra el nombre de la macro adjunta a este dibujo.

// Logs the macro name of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

Volver

String: Es el nombre de la macro adjunta a este dibujo.

Autorización

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

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

`getSheet()`

Muestra la hoja en la que aparece este dibujo.

// Logs the parent sheet of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getSheet());
}

Volver

Sheet: Es la hoja en la que aparece el dibujo.

Autorización

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

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

`getWidth()`

Muestra el ancho real de este dibujo en píxeles.

// Logs the width of all drawings in a sheet
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getWidth());
}

Volver

Integer: Es el ancho del dibujo 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 ámbitos:

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

`getZIndex()`

Muestra el índice z de este dibujo.

// Logs the z-index of all drawings on the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getZIndex());
}

Volver

Number: Es el índice Z de este dibujo.

Autorización

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

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

`remove()`

Borra este dibujo de la hoja de cálculo. Cualquier otra operación en el dibujo generará un error de secuencia de comandos.

// Deletes all drawings from the active sheet.
const drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (let i = 0; i < drawings.length; i++) {
  drawings[i].remove();
}

Autorización

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

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

`setHeight(height)`

Establece la altura real de este dibujo en píxeles.

Parámetros

Nombre	Tipo	Descripción
`height`	`Integer`	Es la altura deseada en píxeles.

Volver

Drawing: Este dibujo, para encadenar.

Autorización

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

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

`setOnAction(macroName)`

Asigna una función de macro a este dibujo.

Parámetros

Nombre	Tipo	Descripción
`macroName`	`String`	Es el nombre de la función de macro.

Volver

Drawing: Este dibujo, para encadenar.

`setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)`

Establece la posición en la que aparece el dibujo en la hoja. Los índices de posición de la fila y la columna de ancla están indexados en 1.

Parámetros

Nombre	Tipo	Descripción
`anchorRowPos`	`Integer`	El lado superior del dibujo está anclado en esta fila.
`anchorColPos`	`Integer`	El lado superior del dibujo está anclado en esta columna.
`offsetX`	`Integer`	Es el desplazamiento horizontal desde la esquina de la celda en píxeles.
`offsetY`	`Integer`	Es el desplazamiento vertical desde la esquina de la celda en píxeles.

Volver

Drawing: Este dibujo, para encadenar.

Autorización

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

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

`setWidth(width)`

Establece el ancho real de este dibujo en píxeles.

Parámetros

Nombre	Tipo	Descripción
`width`	`Integer`	El ancho deseado en píxeles.

Volver

Drawing: Este dibujo, para encadenar.

Autorización

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

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

`setZIndex(zIndex)`

Establece el índice z de este dibujo.

Parámetros

Nombre	Tipo	Descripción
`zIndex`	`Number`	Es el índice z de este dibujo.

Volver

Drawing: Este dibujo, para encadenar.