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

Class RangeList

Una colección de una o más instancias de Range en la misma hoja de cálculo. Puedes usar esta clase para aplicar operaciones en colecciones de celdas o rangos no adyacentes.

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`activate()`	`RangeList`	Selecciona la lista de instancias de `Range`.
`breakApart()`	`RangeList`	Dividir todas las celdas combinadas horizontal o verticalmente en la lista de rangos en celdas individuales nuevamente.
`check()`	`RangeList`	Cambia el estado de las casillas de verificación del rango a “marcado”.
`clear()`	`RangeList`	Borra el rango de contenido, formatos y reglas de validación de datos de cada `Range` en la lista de rangos.
`clear(options)`	`RangeList`	Borra el rango de contenidos, el formato, las reglas de validación de datos y los comentarios, como se especifica con las opciones dadas.
`clearContent()`	`RangeList`	Borra el contenido de cada `Range` en la lista de rangos y deja el formato intacto.
`clearDataValidations()`	`RangeList`	Borra las reglas de validación de datos para cada `Range` en la lista de rangos.
`clearFormat()`	`RangeList`	Borra el formato de texto de cada `Range` en la lista de rangos.
`clearNote()`	`RangeList`	Borra la nota de cada `Range` en la lista de rangos.
`getRanges()`	`Range[]`	Muestra una lista de una o más instancias de `Range` en la misma hoja.
`insertCheckboxes()`	`RangeList`	Inserta casillas de verificación en cada celda del rango, configuradas con `true` para elementos marcados y `false` para elementos desmarcados.
`insertCheckboxes(checkedValue)`	`RangeList`	Inserta casillas de verificación en cada celda del rango configuradas con un valor personalizado para las celdas marcadas y la cadena vacía es desmarcada.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Inserta casillas de verificación en cada celda del rango configuradas con valores personalizados para las casillas marcadas. y sin marcar.
`removeCheckboxes()`	`RangeList`	Quita todas las casillas de verificación del rango.
`setBackground(color)`	`RangeList`	Establece el color de fondo de cada `Range` en la lista de rangos.
`setBackgroundRGB(red, green, blue)`	`RangeList`	Establece el fondo en un color RGB determinado.
`setBorder(top, left, bottom, right, vertical, horizontal)`	`RangeList`	Establece la propiedad de borde de cada `Range` en la lista de rangos.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`RangeList`	Establece la propiedad de borde con color o estilo para cada `Range` de la lista de rangos.
`setFontColor(color)`	`RangeList`	Establece el color de fuente para cada `Range` en la lista de rangos.
`setFontFamily(fontFamily)`	`RangeList`	Establece la familia de fuentes para cada `Range` de la lista de rangos.
`setFontLine(fontLine)`	`RangeList`	Establece el estilo de línea de fuente para cada `Range` en la lista de rangos.
`setFontSize(size)`	`RangeList`	Establece el tamaño de fuente (en puntos) de cada `Range` en la lista de rangos.
`setFontStyle(fontStyle)`	`RangeList`	Establece el estilo de fuente para cada `Range` en la lista de rangos.
`setFontWeight(fontWeight)`	`RangeList`	Establece el grosor de la fuente para cada `Range` en la lista de rangos.
`setFormula(formula)`	`RangeList`	Actualiza la fórmula para cada `Range` en la lista de rangos.
`setFormulaR1C1(formula)`	`RangeList`	Actualiza la fórmula para cada `Range` en la lista de rangos.
`setHorizontalAlignment(alignment)`	`RangeList`	Establece la alineación horizontal para cada `Range` en la lista de rangos.
`setNote(note)`	`RangeList`	Establece el texto de la nota para cada `Range` en la lista de rangos.
`setNumberFormat(numberFormat)`	`RangeList`	Establece el formato de número o de fecha para cada `Range` en la lista de rangos.
`setShowHyperlink(showHyperlink)`	`RangeList`	Establece si cada `Range` de la lista de rangos debe mostrar hipervínculos o no.
`setTextDirection(direction)`	`RangeList`	Establece la dirección del texto de las celdas en cada `Range` de la lista de rangos.
`setTextRotation(degrees)`	`RangeList`	Establece la configuración de rotación de texto de las celdas en cada `Range` de la lista de rangos.
`setValue(value)`	`RangeList`	Establece el valor de cada `Range` en la lista de rangos.
`setVerticalAlignment(alignment)`	`RangeList`	Establece la alineación vertical para cada `Range` en la lista de rangos.
`setVerticalText(isVertical)`	`RangeList`	Establece si se apilan el texto de las celdas de cada `Range` del rango lista.
`setWrap(isWrapEnabled)`	`RangeList`	Establece el ajuste de texto para cada `Range` en la lista de rangos.
`setWrapStrategy(strategy)`	`RangeList`	Establece la estrategia de ajuste de texto para cada `Range` en la lista de rangos.
`trimWhitespace()`	`RangeList`	Corta los espacios en blanco (como espacios, tabulaciones o líneas nuevas) en todas las celdas de esta lista de rangos.
`uncheck()`	`RangeList`	Cambia el estado de las casillas de verificación del rango a "desmarcado".

Documentación detallada

`activate()`

Selecciona la lista de instancias de Range. El último rango de la lista se establece como active range.

Nota: Esto proporciona una manera de realizar una selección múltiple de una serie de rangos.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.activate();

var selection = sheet.getSelection();
// Current cell: B2
var currentCell = selection.getCurrentCell();
// Active range: B2:C4
var activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
var activeRangeList = selection.getActiveRangeList();

Volver

RangeList: Es la lista de rangos activos 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

`breakApart()`

Dividir todas las celdas combinadas horizontal o verticalmente en la lista de rangos en celdas individuales nuevamente.

Llamar a esta función de una lista de rangos equivale a seleccionar un conjunto de rangos y seleccionando la casilla de verificación Formato > Combinar > Separar elemento de menú de Hojas de cálculo.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.breakApart();

Volver

RangeList: Indica esta lista de rangos 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

`check()`

Cambia el estado de las casillas de verificación del rango a “marcado”. Ignora las celdas del rango que actualmente no incluyen el valor configurado ni el que está marcado ni desmarcado.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the ranges D4 and E6 to 'checked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

Volver

RangeList: Indica esta lista de rangos 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

`clear()`

Borra el rango de contenido, formatos y reglas de validación de datos de cada Range en la lista de rangos.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear();

Volver

RangeList: Indica esta lista de rangos 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

`clear(options)`

Borra el rango de contenidos, el formato, las reglas de validación de datos y los comentarios, como se especifica con las opciones dadas. Se borran todos los datos de forma predeterminada.

// The code below clears the contents of the following ranges A:A and C:C in the active sheet,
// but preserves the format, data validation rules, and comments.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

Parámetros

Nombre	Tipo	Descripción
`options`	`Object`	Un objeto JavaScript que especifica parámetros avanzados, como se indica a continuación.

Parámetros avanzados

Nombre	Tipo	Descripción
`commentsOnly`	`Boolean`	Especifica si se deben borrar solo los comentarios.
`contentsOnly`	`Boolean`	Establece si solo se borran los contenidos.
`formatOnly`	`Boolean`	Si se borra solo el formato ten en cuenta que borrar también borra las reglas de validación de datos.
`validationsOnly`	`Boolean`	Especifica si se deben borrar solo las reglas de validación de datos.
`skipFilteredRows`	`Boolean`	Especifica si se debe evitar borrar las filas filtradas.

Volver

RangeList: Indica esta lista de rangos 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

`clearContent()`

Borra el contenido de cada Range en la lista de rangos y deja el formato intacto.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearContent();

Volver

RangeList: Indica esta lista de rangos 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

`clearDataValidations()`

Borra las reglas de validación de datos para cada Range en la lista de rangos.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearDataValidations();

Volver

RangeList: Indica esta lista de rangos 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

`clearFormat()`

Borra el formato de texto de cada Range en la lista de rangos.

Esta acción borra el formato de texto de cada intervalo, pero no restablece ninguna regla de formato de número.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearFormat();

Volver

RangeList: Indica esta lista de rangos 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

`clearNote()`

Borra la nota de cada Range en la lista de rangos.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearNote();

Volver

RangeList: Indica esta lista de rangos 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

`getRanges()`

Muestra una lista de una o más instancias de Range en la misma hoja.

Volver

Range[]: Es la lista de rangos.

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

`insertCheckboxes()`

Inserta casillas de verificación en cada celda del rango, configuradas con true para elementos marcados y false para elementos desmarcados. Establece el valor de todas las celdas en el rango en false.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to
// 'false'.
rangeList.insertCheckboxes();

Volver

RangeList: Indica esta lista de rangos 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

`insertCheckboxes(checkedValue)`

Inserta casillas de verificación en cada celda del rango configuradas con un valor personalizado para las celdas marcadas y la cadena vacía es desmarcada. Establece el valor de cada celda del rango en la cadena vacía.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the ranges D4 and
// E6 to the empty string.
rangeList.insertCheckboxes('yes');

Parámetros

Nombre	Tipo	Descripción
`checkedValue`	`Object`	El valor marcado para la validación de datos de la casilla de verificación.

Volver

RangeList: Indica esta lista de rangos 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

`insertCheckboxes(checkedValue, uncheckedValue)`

Inserta casillas de verificación en cada celda del rango configuradas con valores personalizados para las casillas marcadas. y sin marcar. Establece el valor de cada celda del rango en el valor personalizado sin marcar.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

Parámetros

Nombre	Tipo	Descripción
`checkedValue`	`Object`	El valor marcado para la validación de datos de la casilla de verificación.
`uncheckedValue`	`Object`	El valor desmarcado de la casilla de verificación de validación de datos.

Volver

RangeList: Indica esta lista de rangos 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

`removeCheckboxes()`

Quita todas las casillas de verificación del rango. Borra la validación de datos de cada celda. Además, borra su valor si la celda contiene el valor marcado o no marcado.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

var rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their value.
rangeList1.removeCheckboxes();

var rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear their value.
rangeList2.removeCheckboxes();

Volver

RangeList: Indica esta lista de rangos 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

`setBackground(color)`

Establece el color de fondo de cada Range en la lista de rangos. El color se representa en en notación CSS; por ejemplo, '#ffffff' o 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setBackground('red');

Parámetros

Nombre	Tipo	Descripción
`color`	`String`	El código de color de fondo en notación CSS, como `'#ffffff'` o `'white'`. un valor `null` restablece el color.

Volver

RangeList: Indica esta lista de rangos 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

`setBackgroundRGB(red, green, blue)`

Establece el fondo en un color RGB determinado. Este es un wrapper práctico alrededor de una llamada a setBackground(color).

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

Parámetros

Nombre	Tipo	Descripción
`red`	`Integer`	Es el valor rojo en notación RGB.
`green`	`Integer`	Es el valor verde en notación RGB.
`blue`	`Integer`	Es el valor azul en notación RGB.

Volver

RangeList: Indica esta lista de rangos 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

`setBorder(top, left, bottom, right, vertical, horizontal)`

Establece la propiedad de borde de cada Range en la lista de rangos. Los valores válidos son true (activada), false (desactivada) y null (sin cambios).

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves the left and
// right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

Parámetros

Nombre	Tipo	Descripción
`top`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`left`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`bottom`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`right`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`vertical`	`Boolean`	`true` para bordes verticales internos, `false` para ninguno, `null` para ningún cambio.
`horizontal`	`Boolean`	`true` para bordes horizontales internos, `false` para ninguno, `null` para ningún cambio.

Volver

RangeList: Indica esta lista de rangos 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

`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`

Establece la propiedad de borde con color o estilo para cada Range de la lista de rangos. Los valores válidos son true (activado), false (desactivado) y null (sin cambios). El color es se representa en la notación CSS; Por ejemplo, '#ffffff' o 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged of the ranges
// A2:B4 and C1:D4. Also sets the color to 'red', and the border to 'DASHED'.
rangeList.setBorder(
    true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED);

Parámetros

Nombre	Tipo	Descripción
`top`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`left`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`bottom`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`right`	`Boolean`	`true` para el borde, `false` para ninguno, `null` para ningún cambio.
`vertical`	`Boolean`	`true` para bordes verticales internos, `false` para ninguno, `null` para ningún cambio.
`horizontal`	`Boolean`	`true` para bordes horizontales internos, `false` para ninguno, `null` para ningún cambio.
`color`	`String`	Es el color del borde en notación CSS, como `'#ffffff'` o `'white'`, `null` para el color predeterminado (negro).
`style`	`BorderStyle`	El estilo de los bordes; `null` para el estilo predeterminado (continuo).

Volver

RangeList: Indica esta lista de rangos 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

`setFontColor(color)`

Establece el color de fuente para cada Range en la lista de rangos. El color se representa en CSS notación; por ejemplo, '#ffffff' o 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontColor('red');

Parámetros

Nombre	Tipo	Descripción
`color`	`String`	Es el color de la fuente en la notación CSS, como `'#ffffff'` o `'white'`. pañal El valor `null` restablece el color.

Volver

RangeList: Indica esta lista de rangos 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

`setFontFamily(fontFamily)`

Establece la familia de fuentes para cada Range de la lista de rangos. Se describe la familia de fuentes por un identificador de cadena, como Arial o Roboto.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontFamily('Roboto');

Parámetros

Nombre	Tipo	Descripción
`fontFamily`	`String`	La familia de fuentes que se va a establecer; un valor de `null` restablece la familia de fuentes.

Volver

RangeList: Indica esta lista de rangos 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

`setFontLine(fontLine)`

Establece el estilo de línea de fuente para cada Range en la lista de rangos. Las opciones de estilos de línea son 'underline', 'line-through' o 'none'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontLine('line-through');

Parámetros

Nombre	Tipo	Descripción
`fontLine`	`String`	El estilo de línea de la fuente, ya sea `'underline'`, `'line-through'` o `'none'`; un valor `null` restablece el estilo de la línea de la fuente.

Volver

RangeList: Indica esta lista de rangos 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

`setFontSize(size)`

Establece el tamaño de fuente (en puntos) de cada Range en la lista de rangos.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontSize(20);

Parámetros

Nombre	Tipo	Descripción
`size`	`Integer`	Es un tamaño de punto de fuente.

Volver

RangeList: Indica esta lista de rangos 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

`setFontStyle(fontStyle)`

Establece el estilo de fuente para cada Range en la lista de rangos. Las opciones de estilo de fuente son 'italic' o 'normal'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontStyle("italic");

Parámetros

Nombre	Tipo	Descripción
`fontStyle`	`String`	El estilo de fuente, `'italic'` o `'normal'`; un `null` valor restablece el estilo de fuente.

Volver

RangeList: Indica esta lista de rangos 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

`setFontWeight(fontWeight)`

Establece el grosor de la fuente para cada Range en la lista de rangos. Las opciones de grosor de fuente son 'normal' o 'bold'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontWeight('bold');

Parámetros

Nombre	Tipo	Descripción
`fontWeight`	`String`	El grosor de la fuente, que puede ser `'bold'` o `'normal'`; un `null` restablece el grosor de la fuente.

Volver

RangeList: Indica esta lista de rangos 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

`setFormula(formula)`

Actualiza la fórmula para cada Range en la lista de rangos. La fórmula proporcionada debe tener Notación A1.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
rangeList.setFormula('=SUM(B1:B10)');

Parámetros

Nombre	Tipo	Descripción
`formula`	`String`	Es una cadena que representa la fórmula que se debe establecer.

Volver

RangeList: Indica esta lista de rangos 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

`setFormulaR1C1(formula)`

Actualiza la fórmula para cada Range en la lista de rangos. La fórmula proporcionada debe tener Notación R1C1.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

Parámetros

Nombre	Tipo	Descripción
`formula`	`String`	Fórmula en cadena.

Volver

RangeList: Indica esta lista de rangos 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

`setHorizontalAlignment(alignment)`

Establece la alineación horizontal para cada Range en la lista de rangos. Las opciones de alineación son 'left', 'center' o 'right'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setHorizontalAlignment("center");

Parámetros

Nombre	Tipo	Descripción
`alignment`	`String`	La alineación, ya sea `'left'`, `'center'` o `'normal'` pañal El valor `null` restablece la alineación.

Volver

RangeList: Indica esta lista de rangos 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

`setNote(note)`

Establece el texto de la nota para cada Range en la lista de rangos.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setNote('This is a note');

Parámetros

Nombre	Tipo	Descripción
`note`	`String`	El texto de la nota que se establecerá; un valor `null` quita la nota.

Volver

RangeList: Indica esta lista de rangos 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

`setNumberFormat(numberFormat)`

Establece el formato de número o de fecha para cada Range en la lista de rangos.

Los patrones de formato aceptados se describen en la guía de formato de fechas y números de la API de Hojas de cálculo.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

Parámetros

Nombre	Tipo	Descripción
`numberFormat`	`String`	Es una cadena de formato de número.

Volver

RangeList: Indica esta lista de rangos 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

`setShowHyperlink(showHyperlink)`

Establece si cada Range de la lista de rangos debe mostrar hipervínculos o no.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Show hyperlinks for all the ranges.
rangeList.setShowHyperlink(true);

Parámetros

Nombre	Tipo	Descripción
`showHyperlink`	`Boolean`	Indica si se muestra o no el hipervínculo.

Volver

RangeList: Indica esta lista de rangos 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

`setTextDirection(direction)`

Establece la dirección del texto de las celdas en cada Range de la lista de rangos. Si un la dirección especificada es null, la dirección se infiere y, luego, se establece.

// Sets right-to-left text direction each range in the range list.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parámetros

Nombre	Tipo	Descripción
`direction`	`TextDirection`	La dirección deseada del texto si `null`, la dirección se infiere antes del lugar.

Volver

RangeList: Indica esta lista de rangos 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

`setTextRotation(degrees)`

Establece la configuración de rotación de texto de las celdas en cada Range de la lista de rangos. El entrada corresponde al ángulo entre la orientación de texto estándar y la orientación. Una entrada de cero indica que el texto se estableció con la orientación estándar.

Para la dirección de texto de izquierda a derecha, los ángulos positivos son en sentido antihorario, mientras que de derecha a izquierda están en el sentido de las agujas del reloj.

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

Parámetros

Nombre	Tipo	Descripción
`degrees`	`Integer`	El ángulo deseado entre la orientación estándar y la deseada. Para el texto de izquierda a derecha, los ángulos positivos son en sentido antihorario.

Volver

RangeList: Indica esta lista de rangos 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

`setValue(value)`

Establece el valor de cada Range en la lista de rangos. El valor puede ser numérico, cadena booleano o fecha. Si comienza con “=” se interpreta como una fórmula.

var sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setValue(100);

Parámetros

Nombre	Tipo	Descripción
`value`	`Object`	Es el valor del rango.

Volver

RangeList: Indica esta lista de rangos 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

`setVerticalAlignment(alignment)`

Establece la alineación vertical para cada Range en la lista de rangos. Las opciones de alineación son 'top', 'middle' o 'bottom'.

// Sets the vertical alignment to middle for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment("middle");

Parámetros

Nombre	Tipo	Descripción
`alignment`	`String`	La alineación, ya sea `'top'`, `'middle'` o `'bottom'` pañal El valor `null` restablece la alineación.

Volver

RangeList: Indica esta lista de rangos 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

`setVerticalText(isVertical)`

Establece si se apilan el texto de las celdas de cada Range del rango lista. Si el texto se apila verticalmente, se ignora la configuración de rotación de grados.

// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

Parámetros

Nombre	Tipo	Descripción
`isVertical`	`Boolean`	Indica si se debe apilar o no el texto.

Volver

RangeList: Indica esta lista de rangos 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

`setWrap(isWrapEnabled)`

Establece el ajuste de texto para cada Range en la lista de rangos. Cambio de tamaño de celdas con ajuste habilitado para mostrar todo su contenido. Las celdas con la función de ajuste inhabilitado se muestran tanto como sea posible en la celda. sin cambiar el tamaño o ejecutar varias líneas.

// Enable text wrap for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

Parámetros

Nombre	Tipo	Descripción
`isWrapEnabled`	`Boolean`	Indica si se debe ajustar o no el texto.

Volver

RangeList: Indica esta lista de rangos 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

`setWrapStrategy(strategy)`

Establece la estrategia de ajuste de texto para cada Range en la lista de rangos.

// Sets the list of ranges to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parámetros

Nombre	Tipo	Descripción
`strategy`	`WrapStrategy`	La estrategia de unión deseada

Volver

RangeList: Indica esta lista de rangos 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

`trimWhitespace()`

Corta los espacios en blanco (como espacios, tabulaciones o líneas nuevas) en todas las celdas de esta lista de rangos. Elimina todo el espacio en blanco del principio y del final del texto de cada celda y reduce las subsecuencias de caracteres de espacio en blanco restantes a un solo espacio.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)']);

var rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']);
rangeList.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

Volver

RangeList: Indica esta lista de rangos 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

Consulta también

Range.trimWhitespace()

`uncheck()`

Cambia el estado de las casillas de verificación del rango a "desmarcado". Ignora las celdas del rango que actualmente no incluyen el valor configurado ni el que está marcado ni desmarcado.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the ranges D4 and E6 to 'unchecked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

Volver

RangeList: Indica esta lista de rangos 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