Partager via


Insérer une plage de cellules à l’aide de l’API JavaScript Excel

Cet article fournit un exemple de code qui insère une plage de cellules avec l’API JavaScript Excel. Pour obtenir la liste complète des propriétés et méthodes prises en charge par l’objet Range , consultez la classe Excel.Range.

Remarque

L’API JavaScript Excel ne comprend pas d’objet ou de classe « Cellule ». L’API JavaScript Excel définit plutôt toutes les cellules Excel comme objetsRange. Une cellule individuelle dans l’interface utilisateur d’Excel se traduit par un objetRange avec une cellule dans l’API JavaScript Excel. Un objet Range peut également contenir plusieurs cellules contiguës. Consultez Travailler avec des cellules de calcul à l’aide de l’API JavaScript Excel pour en savoir plus.

Insérer une plage de cellules

L’exemple de code suivant insère une plage de cellules dans l’emplacement B4:E4 et déplace les autres cellules vers le bas pour laisser de l’espace pour les nouvelles cellules.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let range = sheet.getRange("B4:E4");

    range.insert(Excel.InsertShiftDirection.down);

    await context.sync();
});

Données avant l’insertion de la plage

Données dans Excel avant l’insertion de la plage.

Données après l’insertion de la plage

Données dans Excel après l’insertion de la plage.

Voir aussi