Class Banding

Bandas

Accede a las bandas y modifícalas, que son los patrones de color que se aplican a las filas o columnas de un rango. Cada banda consta de un rango y un conjunto de colores para filas, columnas, encabezados y pies de página.

Métodos

Método	Tipo de datos que se devuelve	Descripción breve
copyTo(range)	Banding	Copia esta banda a otro rango.
getFirstColumnColorObject()	Color|null	Devuelve el primer color de columna alternado en el rayado o null si no se configuró ningún color.
getFirstRowColorObject()	Color|null	Devuelve el primer color de fila alternado o null si no se configuró ningún color.
getFooterColumnColorObject()	Color|null	Devuelve el color de la última columna de la banda o null si no se configuró ningún color.
getFooterRowColorObject()	Color|null	Devuelve el color de la última fila en el rayado o null si no se configuró ningún color.
getHeaderColumnColorObject()	Color|null	Devuelve el color de la primera columna en el rayado o null si no se configuró ningún color.
getHeaderRowColorObject()	Color|null	Devuelve el color de la fila del encabezado o null si no se configuró ningún color.
getRange()	Range	Devuelve el rango de esta banda.
getSecondColumnColorObject()	Color|null	Devuelve el segundo color de columna alternado en el banding o null si no se configuró ningún color.
getSecondRowColorObject()	Color|null	Devuelve el segundo color de fila alternado o null si no se configuró ningún color.
remove()	void	Quita las bandas.
setFirstColumnColor(color)	Banding	Establece el primer color de columna que se alterna.
setFirstColumnColorObject(color)	Banding	Establece el primer color de columna alternativo en el rayado.
setFirstRowColor(color)	Banding	Establece el primer color de fila que se alterna.
setFirstRowColorObject(color)	Banding	Establece el primer color de fila alternativo en el rayado.
setFooterColumnColor(color)	Banding	Establece el color de la última columna.
setFooterColumnColorObject(color)	Banding	Establece el color de la última columna en el sombreado.
setFooterRowColor(color)	Banding	Establece el color de la última fila.
setFooterRowColorObject(color)	Banding	Establece el color de la fila del pie de página en el banding.
setHeaderColumnColor(color)	Banding	Establece el color de la columna de encabezado.
setHeaderColumnColorObject(color)	Banding	Establece el color de la columna de encabezado.
setHeaderRowColor(color)	Banding	Establece el color de la fila del encabezado.
setHeaderRowColorObject(color)	Banding	Establece el color de la fila del encabezado.
setRange(range)	Banding	Establece el rango para esta banda.
setSecondColumnColor(color)	Banding	Establece el color de la segunda columna que se alterna.
setSecondColumnColorObject(color)	Banding	Establece el segundo color de columna alternado en el sombreado.
setSecondRowColor(color)	Banding	Establece el color de la segunda fila que se alterna.
setSecondRowColorObject(color)	Banding	Establece el segundo color alternado en el sombreado.

Métodos obsoletos

Método	Tipo de datos que se devuelve	Descripción breve
getFirstColumnColor()	String|null	Devuelve el primer color de columna que se alterna o null si no se configuró ningún color.
getFirstRowColor()	String|null	Devuelve el primer color de fila que se alterna o null si no se configuró ningún color.
getFooterColumnColor()	String|null	Devuelve el color de la última columna o null si no se configuró ningún color.
getFooterRowColor()	String|null	Devuelve el color de la última fila o null si no se configuró ningún color.
getHeaderColumnColor()	String|null	Devuelve el color de la columna del encabezado o null si no se configuró ningún color.
getHeaderRowColor()	String|null	Devuelve el color de la fila del encabezado o null si no se configuró ningún color.
getSecondColumnColor()	String|null	Devuelve el segundo color de la columna que se alterna o null si no se configuró ningún color.
getSecondRowColor()	String|null	Devuelve el segundo color de la fila que se alterna o null si no se configuró ningún color.

Documentación detallada

copyTo(range)

Copia esta banda a otro rango.

Parámetros

Nombre	Tipo	Descripción
range	Range	Es el rango en el que se copiará este sombreado.

Volver

Banding: Es la nueva banda.

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

---

getFirstColumnColorObject()

Devuelve el primer color de columna alternado en el rayado o null si no se configuró ningún color.

Volver

Color|null: Es el primer color de columna alternado en el sombreado o null si no se establece ningún color.

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

---

getFirstRowColorObject()

Devuelve el primer color de fila alternado o null si no se configuró ningún color.

Volver

Color|null: Es el primer color de fila alternado en el rayado o null si no se establece ningún color.

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

---

getFooterColumnColorObject()

Devuelve el color de la última columna de la banda o null si no se configuró ningún color.

Volver

Color|null: Es el color de la última columna en el rayado o null si no se estableció ningún color.

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

---

getFooterRowColorObject()

Devuelve el color de la última fila en el rayado o null si no se configuró ningún color.

Volver

Color|null: Es el color de la fila de pie de página en el intercalado o null si no se configuró ningún color.

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

---

getHeaderColumnColorObject()

Devuelve el color de la primera columna en el rayado o null si no se configuró ningún color.

Volver

Color|null: Es el color de la primera columna en el bandas o null si no se configuró ningún color.

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

---

getHeaderRowColorObject()

Devuelve el color de la fila del encabezado o null si no se configuró ningún color.

Volver

Color|null: Es el color de la fila del encabezado. Muestra null si no se configuró ningún color.

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

---

getRange()

Devuelve el rango de esta banda.

Volver

Range: Es el rango de esta banda.

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

---

getSecondColumnColorObject()

Devuelve el segundo color de columna alternado en el banding o null si no se configuró ningún color.

Volver

Color|null: Es el segundo color alternativo de la columna en el banding o null si no se configuró ningún color.

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

---

getSecondRowColorObject()

Devuelve el segundo color de fila alternado o null si no se configuró ningún color.

Volver

Color|null: Es el segundo color de fila alternado en el rayado o null si no se configuró ningún color.

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

Quita las bandas.

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

---

setFirstColumnColor(color)

Establece el primer color de columna que se alterna.

Parámetros

Nombre	Tipo	Descripción
color	String	El código de color en notación CSS (como '#ffffff' o 'white'), o null para borrar el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setFirstColumnColorObject(color)

Establece el primer color de columna alternativo en el rayado.

Parámetros

Nombre	Tipo	Descripción
color	Color	Es el nuevo primer color alternativo de la columna en el formato de bandas. Si se configura como null, se borra el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setFirstRowColor(color)

Establece el primer color de fila que se alterna.

Parámetros

Nombre	Tipo	Descripción
color	String	El código de color en notación CSS (como '#ffffff' o 'white'), o null para borrar el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setFirstRowColorObject(color)

Establece el primer color de fila alternativo en el rayado.

Parámetros

Nombre	Tipo	Descripción
color	Color	Es el primer color alternativo nuevo en el bandas; si se configura en null, se borra el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setFooterColumnColor(color)

Establece el color de la última columna.

Parámetros

Nombre	Tipo	Descripción
color	String	El código de color en notación CSS (como '#ffffff' o 'white'), o null para borrar el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setFooterColumnColorObject(color)

Establece el color de la última columna en el sombreado.

Parámetros

Nombre	Tipo	Descripción
color	Color	Color nuevo de la última columna en el rayado. Si se configura como null, se borra el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setFooterRowColor(color)

Establece el color de la última fila.

Parámetros

Nombre	Tipo	Descripción
color	String	El código de color en notación CSS (como '#ffffff' o 'white'), o null para borrar el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setFooterRowColorObject(color)

Establece el color de la fila del pie de página en el banding.

Parámetros

Nombre	Tipo	Descripción
color	Color	Es el nuevo color de la fila del pie de página. Si se configura como null, se borra el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setHeaderColumnColor(color)

Establece el color de la columna de encabezado.

Parámetros

Nombre	Tipo	Descripción
color	String	El código de color en notación CSS (como '#ffffff' o 'white'), o null para borrar el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setHeaderColumnColorObject(color)

Establece el color de la columna de encabezado.

Parámetros

Nombre	Tipo	Descripción
color	Color	Color de la nueva columna de encabezado. Si se establece en null, se borra el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setHeaderRowColor(color)

Establece el color de la fila del encabezado.

Parámetros

Nombre	Tipo	Descripción
color	String	El código de color en notación CSS (como '#ffffff' o 'white'), o null para borrar el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setHeaderRowColorObject(color)

Establece el color de la fila del encabezado.

Parámetros

Nombre	Tipo	Descripción
color	Color	Es el nuevo color de la fila del encabezado. Si se configura como null, se borra el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setRange(range)

Establece el rango para esta banda.

Parámetros

Nombre	Tipo	Descripción
range	Range	Es el nuevo rango para esta banda.

Volver

Banding: Esta banda, para encadenar.

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

---

setSecondColumnColor(color)

Establece el color de la segunda columna que se alterna.

Parámetros

Nombre	Tipo	Descripción
color	String	El código de color en notación CSS (como '#ffffff' o 'white'), o null para borrar el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setSecondColumnColorObject(color)

Establece el segundo color de columna alternado en el sombreado.

Parámetros

Nombre	Tipo	Descripción
color	Color	El nuevo segundo color alternativo de la columna en el bandas; si se configura en null, se borra el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setSecondRowColor(color)

Establece el color de la segunda fila que se alterna.

Parámetros

Nombre	Tipo	Descripción
color	String	El código de color en notación CSS (como '#ffffff' o 'white'), o null para borrar el color.

Volver

Banding: Esta banda, para encadenar.

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

---

setSecondRowColorObject(color)

Establece el segundo color alternado en el sombreado.

Parámetros

Nombre	Tipo	Descripción
color	Color	El nuevo segundo color alternado en el bandas; si se configura en null, se borra el color.

Volver

Banding: Esta banda, para encadenar.

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

Métodos obsoletos

getFirstColumnColor()

Obsoleto. Se reemplazó por getFirstColumnColorObject()

Devuelve el primer color de columna que se alterna o null si no se configuró ningún color.

Volver

String|null: Es el código de color en notación CSS (como '#ffffff' o 'white'), o bien null si no se configuró ningún color.

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

---

getFirstRowColor()

Obsoleto. Se reemplazó por getFirstRowColorObject()

Devuelve el primer color de fila que se alterna o null si no se configuró ningún color.

Volver

String|null: Es el código de color en notación CSS (como '#ffffff' o 'white'), o bien null si no se configuró ningún color.

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

---

getFooterColumnColor()

Obsoleto. Se reemplazó por getFooterColumnColorObject()

Devuelve el color de la última columna o null si no se configuró ningún color.

Volver

String|null: Es el código de color en notación CSS (como '#ffffff' o 'white'), o bien null si no se configuró ningún color.

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

---

getFooterRowColor()

Obsoleto. Se reemplazó por getFooterRowColorObject()

Devuelve el color de la última fila o null si no se configuró ningún color.

Volver

String|null: Es el código de color en notación CSS (como '#ffffff' o 'white'), o bien null si no se configuró ningún color.

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

---

getHeaderColumnColor()

Obsoleto. Se reemplazó por getHeaderColumnColorObject()

Devuelve el color de la columna del encabezado o null si no se configuró ningún color.

Volver

String|null: Es el código de color en notación CSS (como '#ffffff' o 'white'), o bien null si no se configuró ningún color.

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

---

getHeaderRowColor()

Obsoleto. Se reemplazó por getHeaderRowColorObject()

Devuelve el color de la fila del encabezado o null si no se configuró ningún color.

Volver

String|null: Es el código de color en notación CSS (como '#ffffff' o 'white'), o bien null si no se configuró ningún color.

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

---

getSecondColumnColor()

Obsoleto. Se reemplazó por getSecondColumnColorObject()

Devuelve el segundo color de la columna que se alterna o null si no se configuró ningún color.

Volver

String|null: Es el color en formato HEX o null si no se configuró ningún color.

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

---

getSecondRowColor()

Obsoleto. Se reemplazó por getSecondRowColorObject()

Devuelve el segundo color de la fila que se alterna o null si no se configuró ningún color.

Volver

String|null: Es el código de color en notación CSS (como '#ffffff' o 'white'), o bien null si no se configuró ningún color.

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