Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.
Ajuster précisément une image à une seule cellule est une exigence courante lors de la conception de tableurs servant de rapports visuels, catalogues de produits, annuaires du personnel, tableaux de bord ou listes d’inventaire. Plutôt que d’étirer une image sur plusieurs cellules ou de la placer de manière approximative sur une feuille de calcul, vous pouvez souhaiter une image nette et liée à la cellule, qui reste alignée avec la cellule qui la contient. Aspose.Cells prend en charge ce scénario de deux manières complémentaires :
Picture à la feuille de calcul, définissez son placement à MoveAndSize, et ajustez ses cellules d’ancrage (upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) de sorte que l’image couvre exactement une cellule.embeddedImage de la cellule. L’image s’ajuste automatiquement à la zone d’affichage de la cellule et se déplace avec elle.
La suite de cet article détaille ces deux approches, explique les API concernées et montre comment les utiliser dans le code.Une image flottante est un objet Picture qui réside sur la couche de dessin de la feuille de calcul. Bien qu’elle ne fasse partie d’aucune cellule à proprement parler, elle est ancrée à une plage de cellules. Les cellules d’ancrage de l’image — ses coins supérieur gauche et inférieur droit — déterminent son étendue visuelle sur la feuille de calcul. Par défaut, une image nouvellement ajoutée s’étend sur plusieurs cellules.
Pour faire en sorte qu’une image flottante couvre exactement une cellule, vous devez :
worksheet.pictures.add(row, column, stream), ce qui ancre la nouvelle image à la cellule indiquée.picture.placement à PlacementType.MoveAndSize afin que l’image se déplace et se redimensionne avec la cellule sous-jacente lorsque l’utilisateur modifie la largeur de colonne ou la hauteur de ligne.L’ancrage de l’image est défini par quatre propriétés d’index de base zéro :
picture.upperLeftRow — l’index de ligne du bord supérieur de l’image.picture.upperLeftColumn — l’index de colonne du bord gauche de l’image.picture.lowerRightRow — l’index de ligne du bord inférieur de l’image. Pour que le bord inférieur de l’image se situe en bas de la ligne r, définissez cette valeur à r + 1.picture.lowerRightColumn — l’index de colonne du bord droit de l’image. Pour que le bord droit de l’image se situe à droite de la colonne c, définissez cette valeur à c + 1.picture.placement est une énumération de type PlacementType qui contrôle le comportement de l’image lorsque l’utilisateur redimensionne la ligne ou la colonne située en dessous. La valeur recommandée pour une image sur une seule cellule est PlacementType.MoveAndSize, qui fait en sorte que l’image se déplace et se redimensionne avec la cellule sous-jacente, en préservant l’ajustement exact.
Workbook (ou ouvrez-en un existant).Worksheet cible via workbook.worksheets[0].worksheet.pictures.add(5, 2, imageBytes) pour ajouter une image ancrée à la cellule C6. Récupérez la référence Picture renvoyée.upperLeftRow = 5, upperLeftColumn = 2, lowerRightRow = 6, lowerRightColumn = 3.picture.placement = PlacementType.MoveAndSize pour maintenir l’image alignée avec C6 lors du redimensionnement de la colonne ou de la ligne..xlsx.
Le code suivant illustre l’approche complète.const AsposeCells = require("aspose.cells.node");
const fs = require("fs");
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
const imageBytes = fs.readFileSync("logo.png");
const picIndex = worksheet.getPictures().add(5, 2, imageBytes);
const picture = worksheet.getPictures().get(picIndex);
picture.setUpperLeftRow(5);
picture.setUpperLeftColumn(2);
picture.setLowerRightRow(6);
picture.setLowerRightColumn(3);
picture.setPlacement(AsposeCells.PlacementType.MoveAndSize);
workbook.save("output.xlsx", AsposeCells.SaveFormat.Xlsx);
Aspose.Cells expose également un mécanisme plus simple pour les images liées à une cellule : la propriété cell.embeddedImage. Affecter des octets d’image à cette propriété attache l’image à la cellule elle-même, comme s’il s’agissait d’un contenu incorporé.
cell.embeddedImage l’option la plus concise lorsque votre objectif est simplement « une image qui réside dans cette cellule ».Workbook (ou ouvrez-en un existant).Worksheet cible via workbook.worksheets[0].fs.readFileSync).worksheet.cells["C6"], soit via worksheet.cells[5, 2].embeddedImage de la cellule..xlsx.
Le code suivant illustre l’approche complète.const AsposeCells = require("aspose.cells.node");
const fs = require("fs");
var workbook = new AsposeCells.Workbook();
var worksheet = workbook.getWorksheets().get(0);
// Get the target cell C6
var cell = worksheet.getCells().get("C6");
// Read the image file into a byte array
var imageData = fs.readFileSync("logo.png");
// Embed the image directly into the cell
cell.setEmbeddedImage(imageData);
// Optionally adjust row height and column width so the embedded image is more visible
worksheet.getCells().setColumnWidth(2, 30); // Column C (index 2)
worksheet.getCells().setRowHeight(5, 100); // Row 6 (index 5)
// Save the resulting workbook as an .xlsx file
workbook.save("output.xlsx", AsposeCells.SaveFormat.Xlsx);
Les deux approches produisent une image qui s’inscrit dans une seule cellule, mais elles diffèrent dans la façon dont l’image est stockée et dont elle se comporte :
Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.