posts

Pour modifier le format numérique d’une plage de cellules, vous utiliserez la propriété numberFormat. Ici par exemple, les colonnes B et D utiliseront le format 0.00 (2 chiffres après la virgule) :

async function colonnesBD() {

  await Excel.run(async (context) => {

    const feuille1 = context.workbook.worksheets.getActiveWorksheet();

    feuille1.getRange("B:B").numberFormat = <any>"0.00";

    feuille1.getRange("D:D").numberFormat = <any>"0.00";

  });

}

Après avoir récupéré la feuille active :

const feuille1 = context.workbook.worksheets.getActiveWorksheet();

La propriété numberFormat des colonnes B et D est modifiée. Remarquez l’utilisation de l’opérateur <any> pour désigner toutes les cellules de la plage :

feuille1.getRange("B:B").numberFormat = <any>"0.00";

feuille1.getRange("D:D").numberFormat = <any>"0.00";

Si vous voulez affecter un format particulier à une plage de cellules, vous devez affecter un tableau de tableaux à la propriété numberFormat. Ce tableau contiendra les divers formats souhaités exprimés sous la forme de chaînes de caractères. Ici par exemple, nous allons modifier le format de la plage C2:D4. Les cellules de la colonne C de cette plage auront le format 0.00 (2 chiffres après la virgule) et les cellules de la colonne D de cette plage auront le format 0.000 (3 chiffres après la virgule) :

async function plageC2D4() {

  await Excel.run(async (context) => {

    const feuille1 = context.workbook.worksheets.getActiveWorksheet();

    feuille1.getRange("C2:D4").numberFormat = [["0.00", "0.000"], ["0.00", "0.000"], ["0.00", "0.000"]];

  });

}

Remarquez le tableau de tableaux affecté à la propriété numberFormat. La plage C2:D4 contient trois lignes de deux colonnes, ce qui explique les données de format passées à la propriété numberFormat :

[["0.00", "0.000"], ["0.00", "0.000"], ["0.00", "0.000"]]

Un autre exemple concernant la modification de l’apparence des feuilles de calcul Excel avec l’API JavaScript. Ici, nous allons modifier la couleur d’arrière-plan et l’alignement de la colonne A. Pour cela, nous agissons sur les propriétés format.horizontalAlignment et format.fill.color de la plage concernée :

async function colonneA() {

  await Excel.run(async (context) => {

    const feuille1 = context.workbook.worksheets.getActiveWorksheet();

    feuille1.getRange("A:A").format.horizontalAlignment = "Right";

    feuille1.getRange("A:A").format.horizontalAlignment = "Right";

    feuille1.getRange("A:A").format.fill.color = "yellow";

  });

}