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

Class Selection

Accédez à la sélection active actuelle dans la feuille active. Une sélection est l'ensemble des cellules dans lesquelles l'utilisateur sont mises en surbrillance dans la feuille. Il peut s'agir de plages non adjacentes. L'une des cellules de la sélection est cellule active, où se trouve le curseur de l'utilisateur. La cellule actuellement sélectionnée est mise en évidence une bordure plus foncée dans l'interface utilisateur de Google Sheets.

var activeSheet = SpreadsheetApp.getActiveSheet();
var rangeList = activeSheet.getRangeList(['A1:B4', 'D1:E4']);
rangeList.activate();

var selection = activeSheet.getSelection();
// Current Cell: D1
console.log('Current Cell: ' + selection.getCurrentCell().getA1Notation());
// Active Range: D1:E4
console.log('Active Range: ' + selection.getActiveRange().getA1Notation());
// Active Ranges: A1:B4, D1:E4
var ranges =  selection.getActiveRangeList().getRanges();
for (var i = 0; i < ranges.length; i++) {
  console.log('Active Ranges: ' + ranges[i].getA1Notation());
}
console.log('Active Sheet: ' + selection.getActiveSheet().getName());

Méthodes

Méthode	Type renvoyé	Brève description
`getActiveRange()`	`Range`	Renvoie la plage sélectionnée dans la feuille active ou `null` s'il n'existe aucune plage active.
`getActiveRangeList()`	`RangeList`	Affiche la liste des plages actives dans la feuille active ou la valeur `null` en l'absence de plages actives. plages.
`getActiveSheet()`	`Sheet`	Affiche la feuille active de la feuille de calcul.
`getCurrentCell()`	`Range`	Renvoie la cellule actuellement sélectionnée (en surbrillance) qui est sélectionnée dans l'une des plages actives ou `null` s'il n'y a pas de cellule active.
`getNextDataRange(direction)`	`Range`	À partir de `current cell` et de `active range` et se déplace dans la direction donnée, renvoie une plage ajustée où le bord approprié du a été déplacée pour couvrir `next data cell` tout en restant recouvrant la cellule actuelle.

Documentation détaillée

`getActiveRange()`

Renvoie la plage sélectionnée dans la feuille active ou null s'il n'existe aucune plage active. Si plusieurs plages sont sélectionnées. Cette méthode renvoie uniquement la dernière plage sélectionnée.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var activeRange = selection.getActiveRange();

Renvois

Range : plage active.

Autorisation

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

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

`getActiveRangeList()`

Affiche la liste des plages actives dans la feuille active ou la valeur null en l'absence de plages actives. plages.

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

var sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
var activeRangeList = sheet.getActiveRangeList();

Renvois

RangeList : liste des plages actives.

Autorisation

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

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

`getActiveSheet()`

Affiche la feuille active de la feuille de calcul.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var activeSheet = selection.getActiveSheet();

Renvois

Sheet : feuille active de la feuille de calcul.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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) qui est sélectionnée dans l'une des plages actives ou null s'il n'y a pas de cellule active.

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

Renvois

Range : cellule active.

Autorisation

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

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

`getNextDataRange(direction)`

À partir de current cell et de active range et se déplace dans la direction donnée, renvoie une plage ajustée où le bord approprié du a été déplacée pour couvrir next data cell tout en restant recouvrant la cellule actuelle. Si la plage active est illimitée le long de la dimension de la direction, la plage active d'origine est renvoyée. S'il n'y a pas de cellule active ou plage active, null est renvoyé. Cela revient à sélectionner une plage dans éditeur et en appuyant sur Ctrl+Shift+[arrow key].

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Makes C3 the current cell and C3:E5 the active range.
sheet.getRange('C3:E5').activate();
// Logs 'C1:E3'
console.log(SpreadsheetApp.getSelection()
                          .getNextDataRange(SpreadsheetApp.Direction.UP)
                          .getA1Notation());

Paramètres

Nom	Type	Description
`direction`	`Direction`	Direction dans laquelle trouver la cellule périphérique de la région de données suivante.

Renvois

Range : plage ajustée qui inclut la cellule de données ou null en l'absence de de votre choix.

Autorisation

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

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