Médiaforma

API JS dans Excel – Sélection de plages dans une feuille

Print Friendly, PDF & Email

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)

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)
Vous avez aimé cet article ? Partagez-le avec vos réseaux...
 
Comments

No comments yet.