Class SpreadsheetApp

Application de feuille de calcul

accéder aux fichiers Google Sheets et les créer ; Cette classe est la classe parente du service Spreadsheet.

Propriétés

PropriétéTypeDescription
AutoFillSeriesAutoFillSeriesÉnumération des types de séries utilisés pour calculer les valeurs remplies automatiquement.
BandingThemeBandingThemeÉnumération des différents thèmes de bandes.
BooleanCriteriaBooleanCriteriaÉnumération des critères booléens de mise en forme conditionnelle.
BorderStyleBorderStyleÉnumération des styles valides pour définir des bordures sur un Range.
ColorTypeColorTypeÉnumération des types de couleurs possibles.
CopyPasteTypeCopyPasteTypeÉnumération des types de collage possibles.
DataExecutionErrorCodeDataExecutionErrorCodeÉnumération des codes d'erreur d'exécution de données possibles.
DataExecutionStateDataExecutionStateÉnumération des différents états d'exécution possibles des données.
DataSourceParameterTypeDataSourceParameterTypeÉnumération des types de paramètres de source de données possibles.
DataSourceRefreshScopeDataSourceRefreshScopeÉnumération des champs d'application possibles de l'actualisation de la source de données.
DataSourceTypeDataSourceTypeÉnumération des types de sources de données possibles.
DataValidationCriteriaDataValidationCriteriaÉnumération représentant les critères de validation des données pouvant être définis sur une plage.
DateTimeGroupingRuleTypeDateTimeGroupingRuleTypeÉnumération de la règle de regroupement par date/heure.
DeveloperMetadataLocationTypeDeveloperMetadataLocationTypeÉnumération des éventuels types d'emplacement des métadonnées de développeur.
DeveloperMetadataVisibilityDeveloperMetadataVisibilityÉnumération des visibilités possibles des métadonnées de développeur.
DimensionDimensionÉnumération des dimensions possibles d'une feuille de calcul.
DirectionDirectionÉnumération des directions possibles qu'il est possible de déplacer dans une feuille de calcul à l'aide des touches fléchées.
FrequencyTypeFrequencyTypeÉnumération des types de fréquence possibles.
GroupControlTogglePositionGroupControlTogglePositionÉnumération des positions auxquelles le bouton de contrôle du groupe peut se trouver.
InterpolationTypeInterpolationTypeÉnumération des types d'interpolation de gradient de condition conditionnelle.
PivotTableSummarizeFunctionPivotTableSummarizeFunctionÉnumération des fonctions pouvant servir à résumer les valeurs d'un tableau croisé dynamique.
PivotValueDisplayTypePivotValueDisplayTypeÉnumération montrant comment un tableau croisé dynamique peut s'afficher.
ProtectionTypeProtectionTypeÉnumération représentant les parties d'une feuille de calcul pouvant être protégées contre les modifications.
RecalculationIntervalRecalculationIntervalÉnumération des intervalles possibles pouvant être utilisés dans le recalcul de la feuille de calcul.
RelativeDateRelativeDateÉnumération des options de date relatives permettant de calculer une valeur à utiliser dans le champ BooleanCriteria basé sur la date.
SheetTypeSheetTypeÉnumération des différents types de feuilles qui peuvent exister dans une feuille de calcul.
SortOrderSortOrderÉnumération d'ordre de tri.
TextDirectionTextDirectionÉnumération d'instructions textuelles valides.
TextToColumnsDelimiterTextToColumnsDelimiterÉnumération des délimiteurs prédéfinis pour le texte fractionné et les colonnes.
ThemeColorTypeThemeColorTypeÉnumération des types de couleurs de thème possibles.
ValueTypeValueTypeÉnumération des types de valeurs renvoyés par Range.getValue() et Range.getValues() à partir de la classe Range du service Spreadsheet. Les valeurs d'énumération listées ci-dessous s'ajoutent à Number, Boolean, Date ou String.
WrapStrategyWrapStrategyÉnumération des stratégies utilisées pour encapsuler les cellules.

Méthodes

MéthodeType renvoyéBrève description
create(name)SpreadsheetCrée une feuille de calcul portant le nom indiqué.
create(name, rows, columns)SpreadsheetCrée une feuille de calcul avec le nom spécifié et le nombre de lignes et de colonnes spécifié.
enableAllDataSourcesExecution()voidAutorise l'exécution de données pour tous les types de sources de données.
enableBigQueryExecution()voidAutorise l'exécution des données pour la source de données BigQuery.
flush()voidApplique toutes les modifications apportées à la feuille de calcul en attente.
getActive()SpreadsheetRenvoie la feuille de calcul actuellement active ou null s'il n'y en a pas.
getActiveRange()RangeRenvoie la plage sélectionnée dans la feuille active ou null s'il n'y a pas de plage active.
getActiveRangeList()RangeListRenvoie la liste des plages actives dans la feuille active ou null si aucune plage n'est sélectionnée.
getActiveSheet()SheetRécupère la feuille active dans une feuille de calcul.
getActiveSpreadsheet()SpreadsheetRenvoie la feuille de calcul actuellement active ou null s'il n'y en a pas.
getCurrentCell()RangeRenvoie la cellule actuellement sélectionnée (en surbrillance) dans l'une des plages actives de la feuille active ou null s'il n'y a pas de cellule.
getSelection()SelectionRenvoie le Selection actuel dans la feuille de calcul.
getUi()UiRenvoie une instance de l'environnement d'interface utilisateur de la feuille de calcul qui permet au script d'ajouter des fonctionnalités telles que des menus, des boîtes de dialogue et des barres latérales.
newCellImage()CellImageBuilderCrée un compilateur pour un CellImage.
newColor()ColorBuilderCrée un compilateur pour un Color.
newConditionalFormatRule()ConditionalFormatRuleBuilderCrée un compilateur pour une règle de mise en forme conditionnelle.
newDataSourceSpec()DataSourceSpecBuilderCrée un compilateur pour un DataSourceSpec.
newDataValidation()DataValidationBuilderCrée un compilateur pour une règle de validation des données.
newFilterCriteria()FilterCriteriaBuilderCrée un compilateur pour un FilterCriteria.
newRichTextValue()RichTextValueBuilderCrée un compilateur pour une valeur de texte enrichi.
newTextStyle()TextStyleBuilderCrée un compilateur pour un style de texte.
open(file)SpreadsheetOuvre la feuille de calcul correspondant à l'objet File donné.
openById(id)SpreadsheetOuvre la feuille de calcul correspondant à l'ID indiqué.
openByUrl(url)SpreadsheetOuvre la feuille de calcul avec l'URL donnée.
setActiveRange(range)RangeDéfinit la plage spécifiée en tant que active range, et la cellule en haut à gauche dans la plage en tant que current cell.
setActiveRangeList(rangeList)RangeListDéfinit la liste de plages spécifiée comme active ranges.
setActiveSheet(sheet)SheetDéfinit la feuille active dans une feuille de calcul.
setActiveSheet(sheet, restoreSelection)SheetDéfinit la feuille active dans une feuille de calcul, avec la possibilité de restaurer la sélection la plus récente dans cette feuille.
setActiveSpreadsheet(newActiveSpreadsheet)voidDéfinit la feuille de calcul active.
setCurrentCell(cell)RangeDéfinit la cellule spécifiée comme current cell.

Documentation détaillée

create(name)

Crée une feuille de calcul portant le nom indiqué.

// The code below creates a new spreadsheet "Finances" and logs the URL for it
var ssNew = SpreadsheetApp.create("Finances");
Logger.log(ssNew.getUrl());

Paramètres

NomTypeDescription
nameStringNom de la feuille de calcul.

Aller-retour

Spreadsheet : nouvelle feuille de calcul

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

create(name, rows, columns)

Crée une feuille de calcul avec le nom spécifié et le nombre de lignes et de colonnes spécifié.

// The code below creates a new spreadsheet "Finances" with 50 rows and 5 columns and logs the
// URL for it
var ssNew = SpreadsheetApp.create("Finances", 50, 5);
Logger.log(ssNew.getUrl());

Paramètres

NomTypeDescription
nameStringNom de la feuille de calcul.
rowsIntegerNombre de lignes de la feuille de calcul.
columnsIntegerNombre de colonnes de la feuille de calcul.

Aller-retour

Spreadsheet : nouvelle feuille de calcul

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

enableAllDataSourcesExecution()

Autorise l'exécution de données pour tous les types de sources de données.

L'exécution des données génère une exception si le type de source de données n'est pas activé. Cette méthode permet d'activer l'exécution des données pour tous les types de sources de données.

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/bigquery.readonly

enableBigQueryExecution()

Autorise l'exécution des données pour la source de données BigQuery.

L'exécution de données pour la source de données BigQuery génère une exception si elle n'est pas activée.

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/bigquery.readonly

flush()

Applique toutes les modifications apportées à la feuille de calcul en attente.

Les opérations de feuille de calcul sont parfois regroupées afin d'améliorer les performances, par exemple lorsque vous effectuez plusieurs appels à Range.getValue(). Cependant, il peut parfois être utile de vous assurer que toutes les modifications en attente sont effectuées immédiatement, par exemple pour afficher les données des utilisateurs lorsqu'un script est en cours d'exécution.

// The code below changes the background color of cells A1 and B1 twenty times. You should be
// able to see the updates live in the spreadsheet. If flush() is not called, the updates may
// be applied live or may all be applied at once when the script completes.
function colors() {
  var sheet = SpreadsheetApp.getActiveSheet();
  for (var i = 0; i < 20; i++) {
    if ((i % 2) == 0) {
      sheet.getRange('A1').setBackground('green');
      sheet.getRange('B1').setBackground('red');
    } else {
      sheet.getRange('A1').setBackground('red');
      sheet.getRange('B1').setBackground('green');
    }
    SpreadsheetApp.flush();
  }
}

getActive()

Renvoie la feuille de calcul actuellement active ou null s'il n'y en a pas.

Les fonctions exécutées dans le contexte d'une feuille de calcul peuvent obtenir une référence à l'objet Feuille de calcul correspondant en appelant cette fonction.

// The code below logs the URL for the active spreadsheet.
Logger.log(SpreadsheetApp.getActive().getUrl());

Aller-retour

Spreadsheet : objet de feuille de calcul actif

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

getActiveRange()

Renvoie la plage sélectionnée dans la feuille active ou null s'il n'y a pas de plage active. Si plusieurs plages sont sélectionnées, cette méthode ne renvoie que la dernière plage sélectionnée.

Cela signifie généralement la plage qu'un utilisateur a sélectionnée dans la feuille active, mais dans une fonction personnalisée, elle fait référence à la cellule qui est recalculée activement.

// The code below logs the background color for the active range.
var colorObject = SpreadsheetApp.getActiveRange().getBackgroundObject();
// Assume the color has ColorType.RGB.
Logger.log(colorObject.asRgbColor().asHexString());

Aller-retour

Range : plage active.

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

getActiveRangeList()

Renvoie la liste des plages actives dans la feuille active ou null si aucune plage n'est sélectionnée. La plage active contenant la cellule actuellement sélectionnée est placée en dernier dans la liste.

Si une seule plage est sélectionnée, cette plage se comporte comme un appel getActiveRange().

// Returns the list of active ranges.
var rangeList = SpreadsheetApp.getActiveRangeList();

Aller-retour

RangeList : liste des plages actives

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

getActiveSheet()

Récupère la feuille active dans une feuille de calcul.

La feuille active est celle qui s'affiche dans l'interface utilisateur de la feuille de calcul.

// The code below logs the name of the active sheet.
Logger.log(SpreadsheetApp.getActiveSheet().getName());

Aller-retour

Sheet : objet Sheets actif

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

getActiveSpreadsheet()

Renvoie la feuille de calcul actuellement active ou null s'il n'y en a pas.

Les fonctions exécutées dans le contexte d'une feuille de calcul peuvent obtenir une référence à l'objet Spreadsheet correspondant en appelant cette fonction.

// The code below logs the URL for the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getUrl());

Aller-retour

Spreadsheet : objet de feuille de calcul actif

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

getCurrentCell()

Renvoie la cellule actuellement sélectionnée (en surbrillance) dans l'une des plages actives de la feuille active ou null s'il n'y a pas de cellule.

// Returns the current highlighted cell in the one of the active ranges.
var currentCell = SpreadsheetApp.getCurrentCell();

Aller-retour

Range : cellule actuellement sélectionnée

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

getSelection()

Renvoie le Selection actuel dans la feuille de calcul.

var selection = SpreadsheetApp.getSelection();
var currentCell = selection.getCurrentCell();

Aller-retour

Selection : sélection actuelle

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

getUi()

Renvoie une instance de l'environnement d'interface utilisateur de la feuille de calcul qui permet au script d'ajouter des fonctionnalités telles que des menus, des boîtes de dialogue et des barres latérales. Un script ne peut interagir avec l'interface utilisateur de l'instance actuelle d'une feuille de calcul ouverte que s'il est lié à la feuille de calcul. Pour en savoir plus, consultez les guides des menus, ainsi que les boîtes de dialogue et les barres latérales.

// Add a custom menu to the active spreadsheet, including a separator and a sub-menu.
function onOpen(e) {
  SpreadsheetApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(SpreadsheetApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

Aller-retour

Ui : instance de l'environnement d'interface utilisateur de cette feuille de calcul


newCellImage()

Crée un compilateur pour un CellImage.

Aller-retour

CellImageBuilder : nouvel outil de création


newColor()

Crée un compilateur pour un Color.

var rgbColor = SpreadsheetApp.newColor().setRgbColor("#FF0000").build();

Aller-retour

ColorBuilder : nouvel outil de création


newConditionalFormatRule()

Crée un compilateur pour une règle de mise en forme conditionnelle.

// Adds a conditional format rule to a sheet that causes all cells in range A1:B3 to turn red
// if they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActive().getActiveSheet();
var range = sheet.getRange('A1:B3');
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build()
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Aller-retour

ConditionalFormatRuleBuilder : nouveau compilateur.


newDataSourceSpec()

Crée un compilateur pour un DataSourceSpec.

Aller-retour

DataSourceSpecBuilder : nouvel outil de création


newDataValidation()

Crée un compilateur pour une règle de validation des données.

var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireNumberBetween(1, 100)
    .setAllowInvalid(false)
    .setHelpText('Number must be between 1 and 100.')
    .build();
cell.setDataValidation(rule);

Aller-retour

DataValidationBuilder : nouvel outil de création


newFilterCriteria()

Crée un compilateur pour un FilterCriteria.

Aller-retour

FilterCriteriaBuilder : le nouveau compilateur


newRichTextValue()

Crée un compilateur pour une valeur de texte enrichi.

// Sets cell A1 to have the text "Hello world", with "Hello" bolded.
var cell = SpreadsheetApp.getActive().getRange('A1');
var bold = SpreadsheetApp.newTextStyle().setBold(true).build();
var value = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
cell.setRichTextValue(value);

Aller-retour

RichTextValueBuilder : nouvel outil de création


newTextStyle()

Crée un compilateur pour un style de texte.

// Sets range A1:B3 to have red, size 22, bolded, underlined text.
var range = SpreadsheetApp.getActive().getRange('A1:B3');
var style = SpreadsheetApp.newTextStyle()
    .setForegroundColor("red")
    .setFontSize(22)
    .setBold(true)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

Aller-retour

TextStyleBuilder : nouvel outil de création


open(file)

Ouvre la feuille de calcul correspondant à l'objet File donné.

// Get any starred spreadsheets from Google Drive, then open the spreadsheets and log the name
// of the first sheet within each spreadsheet.
var files = DriveApp.searchFiles(
    'starred = true and mimeType = "' + MimeType.GOOGLE_SHEETS + '"');
while (files.hasNext()) {
  var spreadsheet = SpreadsheetApp.open(files.next());
  var sheet = spreadsheet.getSheets()[0];
  Logger.log(sheet.getName());
}

Paramètres

NomTypeDescription
fileFileFichier à ouvrir.

Aller-retour

Spreadsheet : feuille de calcul

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

openById(id)

Ouvre la feuille de calcul correspondant à l'ID indiqué. Un ID de feuille de calcul peut être extrait de son URL. Par exemple, l'ID de la feuille de calcul dans l'URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 est "abc1234567".

// The code below opens a spreadsheet using its ID and logs the name for it.
// Note that the spreadsheet is NOT physically opened on the client side.
// It is opened on the server only (for modification by the script).
var ss = SpreadsheetApp.openById("abc1234567");
Logger.log(ss.getName());

Paramètres

NomTypeDescription
idStringIdentifiant unique de la feuille de calcul.

Aller-retour

Spreadsheet : objet de feuille de calcul avec l'ID donné

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

openByUrl(url)

Ouvre la feuille de calcul avec l'URL donnée. Lève une exception de script si l'URL n'existe pas ou si l'utilisateur n'est pas autorisé à y accéder.

// The code below opens a spreadsheet using its id and logs the name for it.
// Note that the spreadsheet is NOT physically opened on the client side.
// It is opened on the server only (for modification by the script).
var ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc1234567/edit');
Logger.log(ss.getName());

Paramètres

NomTypeDescription
urlStringURL de la feuille de calcul.

Aller-retour

Spreadsheet : objet de feuille de calcul avec l'ID donné

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

setActiveRange(range)

Définit la plage spécifiée en tant que active range, et la cellule en haut à gauche dans la plage en tant que current cell.

L'interface utilisateur de la feuille de calcul affiche la feuille contenant la plage choisie, puis sélectionne les cellules définies dans cette plage.

// The code below sets range C1:D4 in the first sheet as the active range.
var range = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('C1:D4');
SpreadsheetApp.setActiveRange(range);

var selection = SpreadsheetApp.getSelection();
// Current cell: C1
var currentCell = selection.getCurrentCell();
// Active Range: C1:D4
var activeRange = selection.getActiveRange();

Paramètres

NomTypeDescription
rangeRangePlage à laquelle la plage devient active.

Aller-retour

Range : nouvelle plage active


setActiveRangeList(rangeList)

Définit la liste de plages spécifiée comme active ranges. La dernière plage de la liste est définie en tant que active range.

// The code below sets ranges [D4, B2:C4] in the active sheet as the active ranges.
var rangeList = SpreadsheetApp.getActiveSheet().getRanges(['D4', 'B2:C4']);
SpreadsheetApp.setActiveRangeList(rangeList);

var selection = SpreadsheetApp.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();

Paramètres

NomTypeDescription
rangeListRangeListListe des plages à sélectionner.

Aller-retour

RangeList : nouvelle 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

setActiveSheet(sheet)

Définit la feuille active dans une feuille de calcul. L'interface utilisateur de Google Sheets affiche la feuille choisie, sauf si celle-ci appartient à une autre feuille de calcul.

// The code below makes the 2nd sheet active in the active spreadsheet.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
SpreadsheetApp.setActiveSheet(spreadsheet.getSheets()[1]);

Paramètres

NomTypeDescription
sheetSheetNouvelle feuille active.

Aller-retour

Sheet : feuille transformée en nouvelle feuille active


setActiveSheet(sheet, restoreSelection)

Définit la feuille active dans une feuille de calcul, avec la possibilité de restaurer la sélection la plus récente dans cette feuille. L'interface utilisateur de Google Sheets affiche la feuille sélectionnée, sauf si celle-ci appartient à une autre feuille de calcul.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var firstSheet = spreadsheet.getSheets()[0];
var secondSheet = spreadsheet.getSheets()[1];
// Set the first sheet as the active sheet and select the range D4:F4.
spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate();

// Switch to the second sheet to do some work.
spreadsheet.setActiveSheet(secondSheet);
// Switch back to first sheet, and restore its selection.
spreadsheet.setActiveSheet(firstSheet, true);

// The selection of first sheet is restored, and it logs D4:F4
var range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

Paramètres

NomTypeDescription
sheetSheetNouvelle feuille active.
restoreSelectionBooleanSi la valeur est true, la sélection la plus récente de la nouvelle feuille est resélectionnée lorsque la nouvelle feuille devient active. Si la valeur est false, la nouvelle feuille est activée sans modifier la sélection actuelle.

Aller-retour

Sheet : nouvelle feuille active

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

setActiveSpreadsheet(newActiveSpreadsheet)

Définit la feuille de calcul active.

// The code below makes the spreadsheet with key "1234567890" the active spreadsheet
var ss = SpreadsheetApp.openById("1234567890");
SpreadsheetApp.setActiveSpreadsheet(ss);

Paramètres

NomTypeDescription
newActiveSpreadsheetSpreadsheetFeuille de calcul à utiliser comme feuille de calcul active.

setCurrentCell(cell)

Définit la cellule spécifiée comme current cell.

Si la cellule spécifiée est présente dans une plage déjà sélectionnée, cette plage devient la plage active, la cellule étant considérée comme active.

Si la cellule spécifiée n'est présente dans aucune plage sélectionnée, la sélection existante est supprimée, et la cellule devient la cellule active et la plage active.

Remarque : La valeur Range spécifiée doit comporter une seule cellule. Sinon, cette méthode génère une exception.

// The code below sets the cell B5 in the first sheet as the current cell.
var cell = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('B5');
SpreadsheetApp.setCurrentCell(cell);

var selection = SpreadsheetApp.getSelection();
// Current cell: B5
var currentCell = selection.getCurrentCell();

Paramètres

NomTypeDescription
cellRangeCellule à définir comme cellule actuelle.

Aller-retour

Range : cellule actuellement définie

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