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

Class Drawing

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

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`getContainerInfo()`	`ContainerInfo`	Obtiene información sobre la posición del 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`	Elimina 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 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 la posición del dibujo en la hoja.

Devolvedor

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

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
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getHeight());
}

Devolvedor

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

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.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getOnAction());
}

Devolvedor

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

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.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getSheet());
}

Devolvedor

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

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
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getWidth());
}

Devolvedor

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

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.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var i = 0; i < drawings.length; i++) {
  Logger.log(drawings[i].getZIndex());
}

Devolvedor

Number: Í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 alcances:

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

`remove()`

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

// Deletes all drawings from the active sheet.
var drawings = SpreadsheetApp.getActiveSheet().getDrawings();
for (var 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 alcances:

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`	La altura deseada en píxeles.

Devolvedor

Drawing: Este dibujo, 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

`setOnAction(macroName)`

Asigna una función macro a este dibujo.

Parámetros

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

Devolvedor

Drawing: Este dibujo, para encadenamiento.

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

Establece la posición en la que aparece el dibujo en la hoja. Los índices de posición de fila y columna de anclaje se indexan con el valor 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`	Desplazamiento horizontal desde la esquina de la celda en píxeles.
`offsetY`	`Integer`	Desplazamiento vertical desde la esquina de la celda en píxeles.

Devolvedor

Drawing: Este dibujo, 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

`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.

Devolvedor

Drawing: Este dibujo, 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

`setZIndex(zIndex)`

Establece el índice z de este dibujo.

Parámetros

Nombre	Tipo	Descripción
`zIndex`	`Number`	Índice Z de este dibujo.

Devolvedor

Drawing: Este dibujo, para encadenamiento.