Partager via

Définir le format de plage à l’aide de l’API JavaScript Excel

  • Article

Cet article fournit des exemples de code qui définissent la couleur de police, la couleur de remplissage et le format numérique des cellules d’une plage 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 , voir 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.

Définir la couleur de police et la couleur de remplissage

L’exemple de code ci-dessous définit la couleur de police et la couleur de remplissage des cellules de la plage B2:E2.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let range = sheet.getRange("B2:E2");
    range.format.fill.color = "#4472C4";
    range.format.font.color = "white";

    await context.sync();
});

Données de la plage avant la définition de la couleur de police et de la couleur de remplissage

Données dans Excel avant la définition du format.

Données de la plage après la définition de la couleur de police et de la couleur de remplissage

Données dans Excel une fois le format défini.

Définir le format de nombre

L’exemple de code ci-dessous définit le format de nombre des cellules dans la plage D3:E5.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let formats = [
        ["0.00", "0.00"],
        ["0.00", "0.00"],
        ["0.00", "0.00"]
    ];

    let range = sheet.getRange("D3:E5");
    range.numberFormat = formats;

    await context.sync();
});

Données de la plage avant la définition du format de nombre

Données dans Excel avant la définition du format numérique.

Données de la plage après la définition du format de nombre

Données dans Excel une fois le format numérique défini.

Voir aussi