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 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`	Devuelve 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 la posición del 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 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());
}

Volver

Integer: Indica 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());
}

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

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

`getSheet()`

Devuelve 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());
}

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

Volver

Integer: Indica 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());
}

Volver

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

Borra este dibujo de la hoja de cálculo. Cualquier otra operación en el dibujo dará como resultado una 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`	Es la altura deseada en píxeles.

Volver

Drawing: Este dibujo, 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/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`	Nombre de la función de macro.

Volver

Drawing: Este dibujo, para el encadenamiento.

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

Establece la posición en la que aparece el dibujo en la hoja. La posición de la fila y la columna del anclaje los índices tienen el índice 1.

Parámetros

Nombre	Tipo	Descripción
`anchorRowPos`	`Integer`	El lado superior del dibujo queda anclado en esta fila.
`anchorColPos`	`Integer`	La parte superior del dibujo está anclada 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.

Volver

Drawing: Este dibujo, 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/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`	Es el ancho deseado en píxeles.

Volver

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

Volver

Drawing: Este dibujo, para el encadenamiento.