Voyons comment sélectionner une plage de cellules dans la feuille active. Nous allons par exemple sélectionner la plage A1:B8 dans cette feuille de calcul :
Voici le code utilisé :
async function run() {
await Excel.run(async function(context) {
const ws = context.workbook.worksheets.getActiveWorksheet();
ws.getRange('A1:D6').select();
});
}
Et voici le résultat :
Supposons que la plage A1:D6 ait été nommée Plage1. Pour la sélectionner, vous pouvez utiliser l’instruction :
ws.getRange('Plage1').select();
A la place de :
ws.getRange('A1:D6').select();
En utilisant la fonction getRangeByIndexes(), vous pouvez sélectionner les cellules par leurs emplacements dans la feuille :
getRangeByIndexes(ld, cd, nl, nc)
Où ld représente la ligne de départ, cd la colonne de départ, nl le nombre de lignes et nc le nombre de colonnes.
Par exemple, pour sélectionner la plage A1:D6, vous utiliserez cette instruction :
ws.getRangeByIndexes(0, 0, 6, 4).select();
Pour sélectionner de la plage qui contient des données dans la feuille, vous utiliserez la fonction getUsedRange() :
ws.getUsedRange().select();
Enfin, pour sélectionner la totalité de la feuille, vous utiliserez la fonction getRange() :
ws.getRange().select();
Voici quelques autres instructions intéressantes :
let plage = ws.getRange('A1:D1');
plage.getEntireColumn().select(); // Sélection des colonnes A à D
let plage = ws.getRange('A1:A6');
plage.getEntireRow().select();// Sélection des lignes 1 à 6
plage.getColumnsAfter(3).select(); //Sélection des 3 colonnes après la plage (même nb de lignes)
plage.getRowsBelow(3).select(); //Sélection des 3 lignes après la plage (même nb de colonnes)
plage.getRow(2).select(); //2ème ligne de la plage (basé 0)
plage.getCell(2,3).select(); //2ème ligne 3ème colonne de la sélection (basé 0)
let plage = ws.getRange('A1:D6');
plage.load('cellCount');
await context.sync();
console.log(plage.cellCount); // Nombre de cellules sélectionnées (ici, 24)
