Ensemble d'une ou plusieurs instances Range
dans la même feuille. Vous pouvez utiliser cette classe pour appliquer des opérations sur des ensembles de plages ou de cellules non adjacentes.
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
activate() | RangeList | Sélectionne la liste des instances Range . |
breakApart() | RangeList | Divisez à nouveau toutes les cellules fusionnées horizontalement ou verticalement contenues dans la liste de plages en cellules individuelles. |
check() | RangeList | Définit l'état des cases à cocher de la plage sur "cochée". |
clear() | RangeList | Efface la plage de contenus, de formats et de 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 des plages, sans modifier la mise en forme. |
clearDataValidations() | RangeList | Efface les règles de validation des données pour chaque Range de la liste des plages. |
clearFormat() | RangeList | Efface la mise en forme du texte de 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ées avec true pour cochée et false pour décochée. |
insertCheckboxes(checkedValue) | RangeList | Insère des cases à cocher dans chaque cellule de la plage, configurées avec une valeur personnalisée pour les cases cochées et la 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ées 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 d'arrière-plan de 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 élément 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 pour chaque Range de la liste des plages. |
setFontFamily(fontFamily) | RangeList | Définit la famille de polices pour chaque Range de la liste des plages. |
setFontLine(fontLine) | RangeList | Définit le style de ligne de la police pour chaque Range de la liste des 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 de chaque Range de la liste des plages. |
setFontWeight(fontWeight) | RangeList | Définissez l'épaisseur de la police pour chaque Range de la liste des 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 chaque Range de la liste de plages doit afficher des liens hypertexte. |
setTextDirection(direction) | RangeList | Définit l'orientation du texte des cellules dans chaque Range de la liste de plages. |
setTextRotation(degrees) | RangeList | Définit les paramètres de rotation du texte pour les cellules de chaque Range de la liste de plages. |
setValue(value) | RangeList | Définit la valeur de chaque Range de la liste de plages. |
setVerticalAlignment(alignment) | RangeList | Définissez l'alignement vertical pour chaque Range de la liste des plages. |
setVerticalText(isVertical) | RangeList | Détermine si le texte des cellules de chaque Range de la liste de plages doit être empilé ou non. |
setWrap(isWrapEnabled) | RangeList | Définissez le retour automatique à la ligne pour chaque Range de la liste de plages. |
setWrapStrategy(strategy) | RangeList | Définit la stratégie de retour à la ligne automatique pour chaque Range de la liste de plages. |
trimWhitespace() | RangeList | Supprime les espaces blancs (espaces, tabulations ou sauts de ligne, par exemple) dans chaque cellule de cette liste de plages. |
uncheck() | RangeList | Définit l'état des cases à cocher 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 en tant que active range
.
Remarque:Cette option 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();
Renvois
RangeList
: liste des plages actives, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
Divisez à nouveau toutes les cellules fusionnées horizontalement ou verticalement contenues dans la liste de plages en cellules individuelles.
Appeler cette fonction sur une liste de plages équivaut à sélectionner un ensemble de plages et à sélectionner l'élément de menu Format > Fusionner > Défusionner Sheets.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.breakApart();
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 à cocher de la plage sur "cochée". Ignore les cellules de la plage qui ne contiennent actuellement pas la valeur cochée ou 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();
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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, de formats et de 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();
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 les paramètres avancés répertoriés ci-dessous. |
Paramètres avancés
Nom | Type | Description |
---|---|---|
commentsOnly | Boolean | Indique s'il faut effacer uniquement les commentaires. |
contentsOnly | Boolean | Indique s'il faut effacer uniquement le contenu. |
formatOnly | Boolean | Indique s'il faut effacer uniquement le format. Notez que cette opération efface également les règles de validation des données. |
validationsOnly | Boolean | Indique s'il faut effacer uniquement les règles de validation des données. |
skipFilteredRows | Boolean | Indique s'il faut éviter d'effacer les lignes filtrées. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 des plages, sans modifier la mise en forme.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearContent();
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 des plages.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearDataValidations();
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de chaque Range
de la liste de plages.
Cette opération efface la mise en forme du texte pour chaque plage, mais ne réinitialise aucune règle de mise en forme des nombres.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearFormat();
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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();
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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.
Renvois
Range[]
: liste des plages.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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ées avec true
pour cochée et false
pour 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();
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 à cocher dans chaque cellule de la plage, configurées avec une valeur personnalisée pour les cases cochées et la 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. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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ées avec des valeurs personnalisées pour les états cochés et décochés. Définit la valeur personnalisée de la cellule 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. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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();
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 d'arrière-plan de chaque Range
de la liste de plages. La couleur est représentée en notation 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 de la couleur de l'arrière-plan au format CSS (par exemple, '#ffffff' ou 'white' ) ; une valeur null réinitialise la couleur. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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é pour 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 au format RVB. |
green | Integer | Valeur du vert au format RVB. |
blue | Integer | Valeur des bleus au format RVB. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 élément Range
de la liste de plages. Les valeurs valides sont true
(activé), false
(désactivé) et null
(pas de 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 valeur et null pour aucune modification. |
left | Boolean | true pour la bordure, false pour aucune valeur et null pour aucune modification. |
bottom | Boolean | true pour la bordure, false pour aucune valeur et null pour aucune modification. |
right | Boolean | true pour la bordure, false pour aucune valeur et null pour aucune modification. |
vertical | Boolean | true pour les bordures verticales internes, false pour aucune valeur et null pour aucune modification. |
horizontal | Boolean | true pour les bordures horizontales internes, false pour aucune valeur et null pour aucune modification. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
(pas de modification). La couleur est représentée en notation 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 valeur et null pour aucune modification. |
left | Boolean | true pour la bordure, false pour aucune valeur et null pour aucune modification. |
bottom | Boolean | true pour la bordure, false pour aucune valeur et null pour aucune modification. |
right | Boolean | true pour la bordure, false pour aucune valeur et null pour aucune modification. |
vertical | Boolean | true pour les bordures verticales internes, false pour aucune valeur et null pour aucune modification. |
horizontal | Boolean | true pour les bordures horizontales internes, false pour aucune valeur et null pour aucune modification. |
color | String | Couleur de la bordure en notation 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 (plein). |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 pour chaque Range
de la liste des plages. La couleur est représentée en 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 la police en notation CSS telle que '#ffffff' ou 'white' . Une valeur null réinitialise la couleur. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 des 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 réinitialise la famille de polices. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 ligne de la police pour chaque Range
de la liste des 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 ligne de la police ('underline' , 'line-through' ou 'none' ). Une valeur null réinitialise le style de ligne de police. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de point de la police. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de chaque Range
de la liste des 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. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 pour chaque Range
de la liste des plages. Les options d'épaisseur de la 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. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 être en
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. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 | Alignement ('left' , 'center' ou 'normal' ). Une valeur null réinitialise l'alignement. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 supprime la note. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de mise en forme 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 au format numérique. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 chaque Range
de la liste de plages doit 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 | Afficher ou non le lien hypertexte. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 l'orientation du texte des cellules dans chaque Range
de la liste de plages. Si la direction indiqué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 | Orientation du texte souhaitée. Si la valeur est null , l'orientation est déduite avant la définition. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 pour les cellules de chaque Range
de la liste de plages. L'entrée correspond à l'angle entre l'orientation du texte standard et l'orientation souhaitée. Une entrée égale à zéro indique que le texte est défini sur l'orientation standard.
Pour le texte de gauche à droite, les angles positifs sont orientés dans le sens inverse des aiguilles d'une montre, et inversement.
// 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 orientés dans le sens inverse des aiguilles d'une montre. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de chaque Range
de la liste de plages. La valeur peut être numérique, chaîne,
booléenne ou date. S'il commence par "=", 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. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 des 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 | Alignement ('top' , 'middle' ou 'bottom' ). Une valeur null réinitialise l'alignement. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de chaque Range
de la liste de plages doit être empilé ou non. Si le texte est empilé verticalement, le paramètre de rotation du texte avec degré 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 | Indique si le texte doit être empilé ou non. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 automatique à la ligne pour chaque Range
de la liste de plages. Le redimensionnement des cellules dont le retour automatique est activé afin d'afficher tout leur contenu. Les cellules dont le retour automatique est désactivé s'affichent autant que possible dans la cellule sans être 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 | Indique si le texte doit être renvoyé à la ligne ou non. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 de retour à la ligne automatique 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. |
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 blancs (espaces, tabulations ou sauts de ligne, par exemple) dans chaque cellule de cette liste de plages. Supprime tous les espaces blancs au début et à la fin du texte de chaque cellule, et réduit à un seul espace toute sous-séquence de caractères d'espace blanc 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)']
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Voir aussi
uncheck()
Définit l'état des cases à cocher de la plage sur "Décochée". Ignore les cellules de la plage qui ne contiennent actuellement pas la valeur cochée ou 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();
Renvois
RangeList
: liste de plages, pour le chaînage.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets