`$excel.cloneCell`¶

Description¶

Clone les éléments de style d'une cellule vers une ou plusieurs autres au sein d'un workbook Excel.

Syntaxe¶

$excel.cloneCell( workbook , rules )

Paramètres¶

workbook pojo

Workbook à traiter

rules map / array

Règle(s) de copie. Les règles sont à passer sous la forme d'un objet de type map contenant les propriétés suivantes:

srcSheet string: Nom de la worksheet contenant la cellule de référence (source)
srcCell string: Coordonnées de la cellule source, selon notation Excel (p.ex "A3")
destSheet string: Optionnel. Nom de la worksheet contenant la cellule de destination. Cette propriété peut être omise si la cellule de destination se trouve dans la même worksheet que la cellule source.
destCell string / array: Coordonnées de la cellule de destination. La valeur peut être une valeur unique ou un tableau de valeurs dans le cas où la cellule source doit être clonée vers plusieurs cellules.
rows number: Nombre de lignes en-dessous de la cellule de destination auxquelles appliquer le clônage. La valeur par défaut est 0 (donc le clônage ne va pas au-delà de la cellule de destination sur l'axe vertical). Une valeur -1 signifie d'appliquer le clônage à toutes les cellules situées en-dessous de la cellule de destination.
cols number: Nombre de colonnes à droite de la cellule de destination auxquelles appliquer le clônage. La valeur par défaut est 0 (donc le clônage ne va pas au-delà de la cellule de destination sur l'axe horizontal). Une valeur -1 signifie d'appliquer le clônage à toutes les cellules situées à droite de la cellule de destination.
cloneValue boolean: Optionnel. Flag true/false indiquant si la valeur doit également être clonée. Par défaut, ce flag est true.
cloneHeight boolean: Optionnel. Flag true/false indiquant si la hauteur de ligne doit également être clonée. Par défaut, ce flag est true.
cloneWidth boolean: Optionnel. Flag true/false indiquant si la largeur de colonne doit également être clonée. Par défaut, ce flag est true.

Le paramètre peut être un tableau de règles définies telles que ci-dessus

Retour¶

Retourne true si la méthode a pu s'exécuter sans erreur, sinon false.

Exemple¶

var xl = $excel.open("C:/Temp/source.xlsx");
$excel.cloneCell(xl, { srcSheet: "Feuil1", srcCell: "B2", destCell: [ "E10", "E12" ] });
$excel.cloneCell(xl, { srcSheet: "Feuil1", srcCell: "C2", destCell: [ "F10", "F12" ] });
$excel.save(xl, "C:/Temp/newfile.xlsx");

$excel.cloneCell¶