Cette page a été traduite par l'API Cloud Translation.

Class RangeList

Une ou plusieurs instances Range dans la même feuille. Vous pouvez utiliser cette classe pour appliquer des opérations à des collections de cellules ou de plages non adjacentes.

Méthodes

Méthode	Type renvoyé	Brève description
`activate()`	`RangeList`	Sélectionne la liste des instances `Range`.
`breakApart()`	`RangeList`	Répartissez à nouveau toutes les cellules fusionnées horizontalement ou verticalement dans la liste de plages en cellules individuelles.
`check()`	`RangeList`	Définit l'état des cases de la plage sur "coché".
`clear()`	`RangeList`	Efface la plage de contenus, les formats et les règles de validation des données pour chaque `Range` de la liste de plages.
`clear(options)`	`RangeList`	Efface la plage de contenus, le format, les règles de validation des données et les commentaires, comme spécifié avec les options fournies.
`clearContent()`	`RangeList`	Efface le contenu de chaque `Range` de la liste, sans modifier la mise en forme.
`clearDataValidations()`	`RangeList`	Efface les règles de validation des données pour chaque `Range` de la liste de plages.
`clearFormat()`	`RangeList`	Efface la mise en forme du texte pour chaque `Range` de la liste de plages.
`clearNote()`	`RangeList`	Efface la note pour chaque `Range` de la liste de plages.
`getRanges()`	`Range[]`	Renvoie une liste d'une ou plusieurs instances `Range` dans la même feuille.
`insertCheckboxes()`	`RangeList`	Insère des cases à cocher dans chaque cellule de la plage, configurée avec `true` pour la case cochée et `false` pour la case décochée.
`insertCheckboxes(checkedValue)`	`RangeList`	Insère des cases dans chaque cellule de la plage, configurée avec une valeur personnalisée pour la case cochée et une chaîne vide pour la case décochée.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Insère des cases à cocher dans chaque cellule de la plage, configurée avec des valeurs personnalisées pour les états cochés et décochés.
`removeCheckboxes()`	`RangeList`	Supprime toutes les cases de la plage.
`setBackground(color)`	`RangeList`	Définit la couleur de l'arrière-plan pour chaque `Range` de la liste de plages.
`setBackgroundRGB(red, green, blue)`	`RangeList`	Définit l'arrière-plan sur la couleur RVB donnée.
`setBorder(top, left, bottom, right, vertical, horizontal)`	`RangeList`	Définit la propriété de la bordure pour chaque `Range` de la liste de plages.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`RangeList`	Définit la propriété de la bordure avec une couleur et/ou un style pour chaque `Range` de la liste de plages.
`setFontColor(color)`	`RangeList`	Définit la couleur de la police de chaque `Range` de la liste de plages.
`setFontFamily(fontFamily)`	`RangeList`	Définit la famille de polices pour chaque `Range` de la liste de plages.
`setFontLine(fontLine)`	`RangeList`	Définit le style de la ligne de police pour chaque `Range` de la liste de plages.
`setFontSize(size)`	`RangeList`	Définit la taille de la police (en points) pour chaque `Range` de la liste de plages.
`setFontStyle(fontStyle)`	`RangeList`	Définissez le style de police pour chaque `Range` de la liste de plages.
`setFontWeight(fontWeight)`	`RangeList`	Définissez l'épaisseur de la police de chaque `Range` de la liste de plages.
`setFormula(formula)`	`RangeList`	Met à jour la formule pour chaque `Range` de la liste de plages.
`setFormulaR1C1(formula)`	`RangeList`	Met à jour la formule pour chaque `Range` de la liste de plages.
`setHorizontalAlignment(alignment)`	`RangeList`	Définissez l'alignement horizontal pour chaque `Range` de la liste de plages.
`setNote(note)`	`RangeList`	Définit le texte de la note pour chaque `Range` de la liste de plages.
`setNumberFormat(numberFormat)`	`RangeList`	Définit le format numérique ou de date pour chaque `Range` de la liste de plages.
`setShowHyperlink(showHyperlink)`	`RangeList`	Détermine si les `Range` de la liste de plages doivent afficher des liens hypertexte.
`setTextDirection(direction)`	`RangeList`	Définit le sens de texte des cellules dans chaque `Range` de la liste de plages.
`setTextRotation(degrees)`	`RangeList`	Définit les paramètres de rotation du texte des cellules pour chaque `Range` de la liste de plages.
`setValue(value)`	`RangeList`	Définit la valeur pour chaque `Range` de la liste de plages.
`setVerticalAlignment(alignment)`	`RangeList`	Définissez l'alignement vertical pour chaque `Range` de la liste de plages.
`setVerticalText(isVertical)`	`RangeList`	Détermine si le texte des cellules doit être empilé ou non pour chaque `Range` de la liste de plages.
`setWrap(isWrapEnabled)`	`RangeList`	Définissez le retour à la ligne automatique pour chaque `Range` de la liste de plages.
`setWrapStrategy(strategy)`	`RangeList`	Définit la stratégie d'encapsulation du texte pour chaque `Range` de la liste de plages.
`trimWhitespace()`	`RangeList`	Supprime les espaces (espaces, tabulations ou sauts de ligne, par exemple) dans chaque cellule de cette liste de plages.
`uncheck()`	`RangeList`	Définit l'état des cases de la plage sur "Décochée".

Documentation détaillée

`activate()`

Sélectionne la liste des instances Range. La dernière plage de la liste est définie sur active range.

Remarque:Cette méthode vous permet de sélectionner plusieurs plages.

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

Aller-retour

RangeList : liste des plages actives pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`breakApart()`

Répartissez à nouveau toutes les cellules fusionnées horizontalement ou verticalement dans la liste de plages en cellules individuelles.

L'appel de cette fonction sur une liste de plages équivaut à sélectionner un ensemble de plages et à sélectionner l'élément de menu Formater > Fusionner > Annuler la fusion.

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

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`check()`

Définit l'état des cases de la plage sur "checked" (sélectionné). Ignore les cellules de la plage qui ne contiennent actuellement ni la valeur cochée, ni la case décochée.

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

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`clear()`

Efface la plage de contenus, les formats et les règles de validation des données pour chaque Range de la liste de plages.

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

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`clear(options)`

Efface la plage de contenus, le format, les règles de validation des données et les commentaires, comme spécifié avec les options fournies. Par défaut, toutes les données sont effacées.

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

Paramètres

Nom	Type	Description
`options`	`Object`	Objet JavaScript qui spécifie des paramètres avancés, comme indiqué ci-dessous.

Paramètres avancés

Nom	Type	Description
`commentsOnly`	`Boolean`	Permet d'indiquer si vous souhaitez effacer uniquement les commentaires.
`contentsOnly`	`Boolean`	Indique si le contenu doit être effacé uniquement.
`formatOnly`	`Boolean`	Permet de spécifier si le formatage doit être effacé ou non. Notez que l'effacement du format supprime également les règles de validation des données.
`validationsOnly`	`Boolean`	Permet d'effacer ou non les règles de validation des données.
`skipFilteredRows`	`Boolean`	Indique s'il faut éviter d'effacer les lignes filtrées.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`clearContent()`

Efface le contenu de chaque Range de la liste, sans modifier la mise en forme.

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

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`clearDataValidations()`

Efface les règles de validation des données pour chaque Range de la liste de plages.

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

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`clearFormat()`

Efface la mise en forme du texte pour chaque Range de la liste de plages.

Cette option efface la mise en forme du texte pour chaque plage, sans réinitialiser les règles de mise en forme des nombres.

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

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`clearNote()`

Efface la note pour chaque Range de la liste de plages.

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

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`getRanges()`

Renvoie une liste d'une ou plusieurs instances Range dans la même feuille.

Aller-retour

Range[] : liste de plages.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`insertCheckboxes()`

Insère des cases à cocher dans chaque cellule de la plage, configurée avec true pour la case cochée et false pour la case décochée. Définit la valeur de toutes les cellules de la plage sur 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();

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`insertCheckboxes(checkedValue)`

Insère des cases dans chaque cellule de la plage, configurée avec une valeur personnalisée pour la case cochée et une chaîne vide pour la case décochée. Définit la valeur de chaque cellule de la plage sur la chaîne vide.

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');

Paramètres

Nom	Type	Description
`checkedValue`	`Object`	Valeur cochée pour la validation des données de la case à cocher.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`insertCheckboxes(checkedValue, uncheckedValue)`

Insère des cases à cocher dans chaque cellule de la plage, configurée avec des valeurs personnalisées pour les états cochés et décochés. Définit la valeur de chaque cellule de la plage sur la valeur personnalisée décochée.

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');

Paramètres

Nom	Type	Description
`checkedValue`	`Object`	Valeur cochée pour la validation des données de la case à cocher.
`uncheckedValue`	`Object`	Valeur décochée pour la validation des données de la case à cocher.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`removeCheckboxes()`

Supprime toutes les cases de la plage. Efface la validation des données de chaque cellule, et efface également sa valeur si la cellule contient la valeur cochée ou décochée.

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

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setBackground(color)`

Définit la couleur de l'arrière-plan pour chaque Range de la liste de plages. La couleur est représentée au format CSS (par exemple, '#ffffff' ou 'white').

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

Paramètres

Nom	Type	Description
`color`	`String`	Code couleur de l'arrière-plan au format CSS, tel que `'#ffffff'` ou `'white'`. Une valeur `null` réinitialise la couleur.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setBackgroundRGB(red, green, blue)`

Définit l'arrière-plan sur la couleur RVB donnée. Il s'agit d'un wrapper de commodité situé autour d'un appel 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);

Paramètres

Nom	Type	Description
`red`	`Integer`	Valeur rouge en notation RVB.
`green`	`Integer`	Valeur verte en notation RVB.
`blue`	`Integer`	Valeur bleue en notation RVB.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

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

Définit la propriété de la bordure pour chaque Range de la liste de plages. Les valeurs valides sont true (activé), false (désactivé) et null (aucune modification).

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

Paramètres

Nom	Type	Description
`top`	`Boolean`	`true` pour la bordure, `false` pour aucune, `null` pour aucune modification.
`left`	`Boolean`	`true` pour la bordure, `false` pour aucune, `null` pour aucune modification.
`bottom`	`Boolean`	`true` pour la bordure, `false` pour aucune, `null` pour aucune modification.
`right`	`Boolean`	`true` pour la bordure, `false` pour aucune, `null` pour aucune modification.
`vertical`	`Boolean`	`true` pour les bordures verticales internes, `false` pour aucune bordure et `null` pour aucune modification.
`horizontal`	`Boolean`	`true` pour les bordures horizontales, `false` pour aucune et `null` pour aucune modification.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

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

Définit la propriété de la bordure avec une couleur et/ou un style pour chaque Range de la liste de plages. Les valeurs valides sont true (activé), false (désactivé) et null (aucun changement). La couleur est représentée au format CSS, par exemple '#ffffff' ou '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);

Paramètres

Nom	Type	Description
`top`	`Boolean`	`true` pour la bordure, `false` pour aucune, `null` pour aucune modification.
`left`	`Boolean`	`true` pour la bordure, `false` pour aucune, `null` pour aucune modification.
`bottom`	`Boolean`	`true` pour la bordure, `false` pour aucune, `null` pour aucune modification.
`right`	`Boolean`	`true` pour la bordure, `false` pour aucune, `null` pour aucune modification.
`vertical`	`Boolean`	`true` pour les bordures verticales internes, `false` pour aucune bordure et `null` pour aucune modification.
`horizontal`	`Boolean`	`true` pour les bordures horizontales, `false` pour aucune et `null` pour aucune modification.
`color`	`String`	Couleur de la bordure au format CSS, comme `'#ffffff'` ou `'white'`, `null` pour la couleur par défaut (noir).
`style`	`BorderStyle`	Style des bordures, `null` pour le style par défaut (solide).

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setFontColor(color)`

Définit la couleur de la police de chaque Range de la liste de plages. La couleur est représentée dans la notation CSS, par exemple '#ffffff' ou 'white'.

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

Paramètres

Nom	Type	Description
`color`	`String`	Couleur de police au format CSS, telle que `'#ffffff'` ou `'white'`. Une valeur `null` réinitialise la couleur.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setFontFamily(fontFamily)`

Définit la famille de polices pour chaque Range de la liste de plages. La famille de polices est décrite par un identifiant de chaîne tel que Arial ou Roboto.

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

Paramètres

Nom	Type	Description
`fontFamily`	`String`	Famille de polices à définir. La valeur `null` permet de réinitialiser la famille de polices.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setFontLine(fontLine)`

Définit le style de la ligne de police pour chaque Range de la liste de plages. Les options de style de ligne sont 'underline', 'line-through' ou 'none'.

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

Paramètres

Nom	Type	Description
`fontLine`	`String`	Style de la police `'underline'`, `'line-through'` ou `'none'`. Une valeur `null` réinitialise le style de la police.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setFontSize(size)`

Définit la taille de la police (en points) pour chaque Range de la liste de plages.

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

Paramètres

Nom	Type	Description
`size`	`Integer`	Taille du point de police.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setFontStyle(fontStyle)`

Définissez le style de police pour chaque Range de la liste de plages. Les options de style de police sont 'italic' ou 'normal'.

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

Paramètres

Nom	Type	Description
`fontStyle`	`String`	Style de police `'italic'` ou `'normal'`. Une valeur `null` réinitialise le style de police.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setFontWeight(fontWeight)`

Définissez l'épaisseur de la police de chaque Range de la liste de plages. Les options d'épaisseur de police sont 'normal' ou 'bold'.

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

Paramètres

Nom	Type	Description
`fontWeight`	`String`	Épaisseur de la police, `'bold'` ou `'normal'`. Une valeur `null` réinitialise l'épaisseur de la police.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setFormula(formula)`

Met à jour la formule pour chaque Range de la liste de plages. La formule donnée doit utiliser la notation A1.

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

Paramètres

Nom	Type	Description
`formula`	`String`	Chaîne représentant la formule à définir.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setFormulaR1C1(formula)`

Met à jour la formule pour chaque Range de la liste de plages. La formule donnée doit être au format 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])');

Paramètres

Nom	Type	Description
`formula`	`String`	Formule de chaîne.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setHorizontalAlignment(alignment)`

Définissez l'alignement horizontal pour chaque Range de la liste de plages. Les options d'alignement sont 'left', 'center' ou 'right'.

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

Paramètres

Nom	Type	Description
`alignment`	`String`	L'alignement, `'left'`, `'center'` ou `'normal'`. Une valeur `null` le réinitialise.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setNote(note)`

Définit le texte de la note pour chaque Range de la liste de plages.

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

Paramètres

Nom	Type	Description
`note`	`String`	Texte de la note à définir. La valeur `null` permet de supprimer la note.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setNumberFormat(numberFormat)`

Définit le format numérique ou de date pour chaque Range de la liste de plages.

Les formats acceptés sont décrits dans le Guide de mise en forme des dates et des nombres dans l'API Sheets.

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');

Paramètres

Nom	Type	Description
`numberFormat`	`String`	Chaîne de format numérique.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setShowHyperlink(showHyperlink)`

Détermine si les Range de la liste de plages doivent afficher des liens hypertexte.

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

Paramètres

Nom	Type	Description
`showHyperlink`	`Boolean`	Indique si le lien hypertexte doit être affiché.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setTextDirection(direction)`

Définit le sens de texte des cellules dans chaque Range de la liste de plages. Si une direction spécifiée est null, elle est déduite, puis définie.

// 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);

Paramètres

Nom	Type	Description
`direction`	`TextDirection`	Direction de texte souhaitée. Si la valeur est `null`, elle est déduite avant la configuration.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setTextRotation(degrees)`

Définit les paramètres de rotation du texte des cellules pour chaque Range de la liste de plages. L'entrée correspond à l'angle entre l'orientation de texte standard et l'orientation souhaitée. Si vous saisissez zéro, cela signifie que le texte est défini sur l'orientation standard.

Pour le texte écrit de gauche à droite, les angles positifs sont dans le sens inverse des aiguilles d'une montre, tandis que les angles positifs sont orientés dans le sens inverse des aiguilles d'une montre.

// 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);

Paramètres

Nom	Type	Description
`degrees`	`Integer`	Angle souhaité entre l'orientation standard et l'orientation souhaitée. Pour le texte de gauche à droite, les angles positifs sont dans le sens inverse des aiguilles d'une montre.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setValue(value)`

Définit la valeur pour chaque Range de la liste de plages. La valeur peut être numérique, chaîne, booléenne ou date. S'il commence par '\t#39; il est interprété comme une formule.

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

Paramètres

Nom	Type	Description
`value`	`Object`	Valeur de la plage.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setVerticalAlignment(alignment)`

Définissez l'alignement vertical pour chaque Range de la liste de plages. Les options d'alignement sont 'top', 'middle' ou '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");

Paramètres

Nom	Type	Description
`alignment`	`String`	L'alignement, `'top'`, `'middle'` ou `'bottom'`. Une valeur `null` le réinitialise.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`setVerticalText(isVertical)`

Détermine si le texte des cellules doit être empilé ou non pour chaque Range de la liste de plages. Si le texte est empilé verticalement, le paramètre de rotation du degré de précision est ignoré.

// 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);

Paramètres

Nom	Type	Description
`isVertical`	`Boolean`	Permet de spécifier si le texte doit être empilé ou non.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setWrap(isWrapEnabled)`

Définissez le retour à la ligne automatique pour chaque Range de la liste de plages. Le contenu des cellules des cellules avec enveloppement est redimensionné. Les cellules pour lesquelles le retour à la ligne est désactivé s'affichent autant que possible dans la cellule, sans avoir été redimensionnées ni exécutées sur plusieurs lignes.

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

Paramètres

Nom	Type	Description
`isWrapEnabled`	`Boolean`	Activer ou non le retour à la ligne automatique.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

`setWrapStrategy(strategy)`

Définit la stratégie d'encapsulation du texte pour chaque Range de la liste de plages.

// 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);

Paramètres

Nom	Type	Description
`strategy`	`WrapStrategy`	Stratégie d'encapsulation souhaitée.

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

`trimWhitespace()`

Supprime les espaces (espaces, tabulations ou sauts de ligne, par exemple) dans chaque cellule de cette liste de plages. Supprime tous les espaces au début et à la fin du texte de chaque cellule, et réduit à un seul espace toute sous-séquence des espaces blancs restants.

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)']

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

Voir aussi

Range.trimWhitespace()

`uncheck()`

Modifie l'état des cases à cocher de la plage pour les décocher. Ignore les cellules de la plage qui ne contiennent actuellement ni la valeur cochée, ni la case décochée.

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

Aller-retour

RangeList : liste de plages pour le chaînage.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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