Class Slicer

Slicer

Representa un control de filtro, que se usa para filtrar rangos, gráficos y tablas dinámicas de forma no colaborativa. Esta clase contiene métodos para acceder a los filtros existentes y modificarlos. Para crear un nuevo filtro, usa Sheet.insertSlicer(range, anchorRowPos, anchorColPos).

Métodos

Método	Tipo de datos que se muestra	Descripción breve
getBackgroundColorObject()	Color	Muestra el Color de fondo del filtro.
getColumnPosition()	Integer	Devuelve la posición de la columna (en relación con el rango de datos del filtro) en la que se aplica el filtro en el filtro, o null si no se establece la posición de la columna.
getContainerInfo()	ContainerInfo	Obtiene información sobre la posición del filtro en la hoja.
getFilterCriteria()	FilterCriteria	Muestra los criterios de filtro del filtro o null si no se establecen.
getRange()	Range	Obtiene el rango de datos al que se aplica el filtro.
getTitle()	String	Devuelve el título del filtro.
getTitleHorizontalAlignment()	String	Obtiene la alineación horizontal del título.
getTitleTextStyle()	TextStyle	Devuelve el estilo de texto del título del filtro.
isAppliedToPivotTables()	Boolean	Muestra si el filtro determinado se aplica a las tablas dinámicas.
remove()	void	Borra el filtro.
setApplyToPivotTables(applyToPivotTables)	Slicer	Establece si el filtro determinado se debe aplicar a las tablas dinámicas de la hoja de cálculo.
setBackgroundColor(color)	Slicer	Establece el color de fondo del filtro.
setBackgroundColorObject(color)	Slicer	Establece el Color de fondo del divisor.
setColumnFilterCriteria(columnPosition, filterCriteria)	Slicer	Establece el índice de columna y los criterios de filtrado del filtro.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)	Slicer	Establece la posición en la que aparece el filtro en la hoja.
setRange(rangeApi)	Slicer	Establece el período de datos en el que se aplica el filtro.
setTitle(title)	Slicer	Establece el título del filtro.
setTitleHorizontalAlignment(horizontalAlignment)	Slicer	Establece la alineación horizontal del título en el filtro.
setTitleTextStyle(textStyle)	Slicer	Establece el estilo de texto del filtro.

Métodos obsoletos

Método	Tipo de datos que se muestra	Descripción breve
getBackgroundColor()	String	Muestra el color de fondo del divisor en notación CSS (como "#ffffff").

Documentación detallada

getBackgroundColorObject()

Muestra el Color de fondo del filtro.

Volver

Color: Es el color de fondo de este filtro. Muestra 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 ámbitos:

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

---

getColumnPosition()

Devuelve la posición de la columna (en relación con el rango de datos del filtro) en la que se aplica el filtro en el filtro, o null si no se establece la posición de la columna. Debe ser la posición con índice 1 de la columna, similar al filtro.

Volver

Integer: Es la posición de la columna de este filtro.

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

---

getContainerInfo()

Obtiene información sobre la posición del filtro en la hoja.

Volver

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

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

---

getFilterCriteria()

Muestra los criterios de filtro del filtro o null si no se establecen.

Volver

FilterCriteria: Son los criterios de filtro de este filtro.

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

---

getRange()

Obtiene el rango de datos al que se aplica el filtro.

Volver

Range: Es el rango del filtro.

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

---

getTitle()

Devuelve el título del filtro.

Volver

String: Este divisor, 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

---

getTitleHorizontalAlignment()

Obtiene la alineación horizontal del título.

Volver

String: Es la alineación horizontal del título de este filtro.

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

---

getTitleTextStyle()

Devuelve el estilo de texto del título del filtro.

Volver

TextStyle: Es el estilo de texto del título de este filtro.

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

---

isAppliedToPivotTables()

Muestra si el filtro determinado se aplica a las tablas dinámicas.

Volver

Boolean: true si este filtro se aplica a tablas dinámicas, de lo contrario, false.

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 el filtro.

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

---

setApplyToPivotTables(applyToPivotTables)

Establece si el filtro determinado se debe aplicar a las tablas dinámicas de la hoja de cálculo.

Parámetros

Nombre	Tipo	Descripción
applyToPivotTables	Boolean	Especifica si este filtro debe aplicarse a las tablas dinámicas.

Volver

Slicer: Este divisor, 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

---

setBackgroundColor(color)

Establece el color de fondo del filtro. Un valor null restablece el color de fondo.

Parámetros

Nombre	Tipo	Descripción
color	String	Es el nuevo color de fondo de este divisor en notación CSS (como "#ffffff").

Volver

Slicer: Este divisor, 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

---

setBackgroundColorObject(color)

Establece el Color de fondo del divisor. Un valor null restablece el color de fondo.

Parámetros

Nombre	Tipo	Descripción
color	Color	Es el nuevo color de fondo de este filtro.

Volver

Slicer: Este divisor, 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

---

setColumnFilterCriteria(columnPosition, filterCriteria)

Establece el índice de columna y los criterios de filtrado del filtro. Un valor null restablece el filtro de fragmento.

Parámetros

Nombre	Tipo	Descripción
columnPosition	Integer	Es la nueva posición de la columna de este filtro.
filterCriteria	FilterCriteria	Los nuevos criterios de filtro de este filtro.

Volver

Slicer: Este divisor, 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

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Establece la posición en la que aparece el filtro 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 filtro está anclado en esta fila.
anchorColPos	Integer	El lado superior del divisor 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

Slicer: Este divisor, 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

---

setRange(rangeApi)

Establece el período de datos en el que se aplica el filtro.

Parámetros

Nombre	Tipo	Descripción
rangeApi	Range	Es el nuevo rango de este filtro.

Volver

Slicer: Este divisor, 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

---

setTitle(title)

Establece el título del filtro. Un título vacío restablece el título al valor predeterminado.

Parámetros

Nombre	Tipo	Descripción
title	String	Es el nuevo título de este filtro.

Volver

Slicer: Este divisor, 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

---

setTitleHorizontalAlignment(horizontalAlignment)

Establece la alineación horizontal del título en el filtro. Un valor null restablece la alineación.

Parámetros

Nombre	Tipo	Descripción
horizontalAlignment	String	Es la nueva alineación horizontal del título de este filtro.

Volver

Slicer: Este divisor, 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

---

setTitleTextStyle(textStyle)

Establece el estilo de texto del filtro.

Parámetros

Nombre	Tipo	Descripción
textStyle	TextStyle	Es el nuevo estilo de texto del título del filtro.

Volver

Slicer: Este divisor, 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

Métodos obsoletos

getBackgroundColor()

Obsoleto. Se reemplazó por getBackgroundColorObject()

Muestra el color de fondo del divisor en notación CSS (como "#ffffff").

Volver

String: Es el color de fondo de este filtro. Muestra 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 ámbitos:

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