Pour récupérer les propriétés d’une cellule (police, taille des caractères, couleur, attributs, couleur d’arrière-plan, etc.), vous utiliserez la méthode getCellProperties(). Indiquez les propriétés que vous voulez récupérer sous la forme d’un objet JSON :
const proprieties = cellule.getCellProperties({
prop: true;
});
Les propriétés récupérables sont listées sur cette page : https://bit.ly/2LQyCVy
A titre d’exemple, nous allons récupérer les propriétés suivantes :
- address
- format/font/name
- format/font/color
- format/font/bold
- format/font/italic
- format/fill/color
- style
Voici le code utilisé :
async function run() {
await Excel.run(async (context) => {
const feuille = context.workbook.worksheets.getActiveWorksheet();
let cellule = feuille.getCell(0,0);
const lesProp = cellule.getCellProperties({
address: true,
format: {
fill: {
color: true
},
font: {
color: true,
bold: true,
italic: true,
name: true
}
},
style: true
})
await context.sync();
const proprietes = lesProp.value;
console.log(proprietes);
});
}
La feuille courante est placée dans la constante feuille :
const feuille = context.workbook.worksheets.getActiveWorksheet();
La cellule dont on veut connaitre les propriétés est la cellule A1 :
let cellule = feuille.getCell(0,0);
Les propriétés de cette cellule sont placées dans la constante lesProp :
const lesProp = cellule.getCellProperties({
address: true,
format: {
fill: {
color: true
},
font: {
color: true,
bold: true,
italic: true,
name: true
}
},
style: true
})
L’instruction await context.sync() synchronise l’état entre les objets proxy de JavaScript et les objets réels dans Excel, ce qui provoque la récupération des propriétés de la cellule A1 :
await context.sync();
L’instruction suivante affiche les propriétés récupérées :
console.log(proprietes.value);
Le résultat est retourné sous la forme d’un tableau. Voici un exemple de ce que vous obtiendrez :
[
[
{
"@odata.type": "Microsoft.ExcelServices.CellPropertiesInternal",
"address": "Sample!A1",
"format": {
"@odata.type": "Microsoft.ExcelServices.CellPropertiesFormatInternal",
"font": {
"@odata.type": "Microsoft.ExcelServices.CellPropertiesFont",
"bold": true,
"color": "#44546A",
"italic": false,
"name": "Calibri"
},
"fill": {
"@odata.type": "Microsoft.ExcelServices.CellPropertiesFill",
"color": "#FFFFFF"
}
},
"style": "Heading1"
}
]
]
Pour afficher ces propriétés dans la console, il suffit d’utiliser des instructions « à point ».
Dans un premier temps, on récupère l’objet JSON contenu dans le tableau de tableau avec cette instruction :
const valeurs = lesProp.value[0][0];
Ensuite, on parse les différentes propriétés et on les affiche dans la console :
console.log(`Adresse : ${valeurs.address}`);
console.log(`Police : ${valeurs.format.font.name}, couleur : ${valeurs.format.font.color}, gras : ${valeurs.format.font.bold}, italique : ${valeurs.format.font.italic}`);
console.log(`Couleur d'arrière-plan : ${valeurs.format.fill.color}`);
console.log(`Style : ${valeurs.style}`);
Voici un exemple d’exécution :
