Gérer les feuilles de calcul des fichiers Microsoft Excel avec Node.js via C++

Aspose.Cells fournit une classe, Workbook, qui représente un fichier Excel. La classe Workbook contient une collection Workbook.getWorksheets() qui permet d’accéder à chaque feuille de calcul dans le fichier Excel.

Une feuille de calcul est représentée par la classe Worksheet. La classe Worksheet offre une large gamme de propriétés et de méthodes pour gérer les feuilles.

Ajout de feuilles de calcul à un nouveau fichier Excel

Pour créer un nouveau fichier Excel de manière programmatique:

  1. Créez un objet de la classe Workbook.
  2. Appelez la méthode WorksheetCollection.add(SheetType) de la classe WorksheetCollection. Une nouvelle feuille de calcul vide est ajoutée au fichier Excel automatiquement. Elle peut être référencée en passant l’indice de la feuille à la collection Workbook.getWorksheets().
  3. Obtenez une référence de feuille de calcul.
  4. Travaillez sur les feuilles de calcul.
  5. Enregistrez le nouveau fichier Excel avec ses nouvelles feuilles en appelant la méthode Workbook.save(string, SaveFormat) de la classe Workbook.
const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Instantiating a Workbook object
const workbook = new AsposeCells.Workbook();

// Adding a new worksheet to the Workbook object
const i = workbook.getWorksheets().getCount();
workbook.getWorksheets().add();

// Obtaining the reference of the newly added worksheet by passing its sheet index
const worksheet = workbook.getWorksheets().get(i);

// Setting the name of the newly added worksheet
worksheet.setName("My Worksheet");

// Saving the Excel file
workbook.save(path.join(dataDir, "output.out.xls"));

Ajout de feuilles de calcul à une feuille de calcul Designer

Le processus d’ajout de feuilles dans un classeur de conception est le même que celui d’ajouter une nouvelle feuille, sauf que le fichier Excel existe déjà et doit être ouvert avant d’ajouter des feuilles. Un fichier de conception peut être ouvert par la classe Workbook.

const fs = require("fs");
const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const inputPath = path.join(dataDir, "book1.xlsx");

// Creating a file stream containing the Excel file to be opened
const fstream = fs.readFileSync(inputPath);

// Opening the Excel file through the file stream
const workbook = new AsposeCells.Workbook(fstream);

// Adding a new worksheet to the Workbook object
const i = workbook.getWorksheets().add();

// Obtaining the reference of the newly added worksheet by passing its sheet index
const worksheet = workbook.getWorksheets().get(i);

// Setting the name of the newly added worksheet
worksheet.setName("My Worksheet");

// Saving the Excel file
workbook.save(path.join(dataDir, "output.xlsx"));

Accéder aux feuilles de calcul en utilisant le nom de la feuille

Accédez à n’importe quelle feuille de calcul en spécifiant son nom ou son index.

const path = require("path");
const fs = require("fs");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const inputPath = path.join(dataDir, "book1.xlsx");

// Creating a file stream containing the Excel file to be opened
const fstream = fs.readFileSync(inputPath);

// Instantiating a Workbook object
// Opening the Excel file through the file stream
const workbook = new AsposeCells.Workbook(fstream);

// Accessing a worksheet using its sheet name
const worksheet = workbook.getWorksheets().get("Sheet1");
const cell = worksheet.getCells().get("A1");
console.log(cell.getValue());

Suppression des feuilles de calcul en utilisant le nom de la feuille

Pour supprimer des feuilles d’un fichier, appelez la méthode WorksheetCollection.removeAt(string) de la classe WorksheetCollection. Passez le nom de la feuille à la méthode WorksheetCollection.removeAt(string) pour supprimer une feuille spécifique.

const fs = require("fs");
const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const filePath = path.join(dataDir, "book1.xls");

// Creating a file stream containing the Excel file to be opened
const fstream = fs.readFileSync(filePath);

// Instantiating a Workbook object
// Opening the Excel file through the file stream
const workbook = new AsposeCells.Workbook(fstream);

// Removing a worksheet using its sheet name
workbook.getWorksheets().removeAt("Sheet1");

// Save workbook
workbook.save(path.join(dataDir, "output.out.xls"));

Suppression des feuilles de calcul en utilisant l’indice de la feuille

Supprimer des feuilles par nom fonctionne bien lorsque le nom de la feuille est connu. Si vous ne connaissez pas le nom de la feuille, utilisez une version surchargée de la méthode WorksheetCollection.removeAt(string) qui prend l’indice de la feuille de calcul plutôt que son nom.

const fs = require("fs");
const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const filePath = path.join(dataDir, "book1.xls");

// Creating a file stream containing the Excel file to be opened
const fstream = fs.readFileSync(filePath);

// Instantiating a Workbook object
// Opening the Excel file through the file stream
const workbook = new AsposeCells.Workbook(fstream);

// Removing a worksheet using its sheet index
workbook.getWorksheets().removeAt(0);

// Save workbook
workbook.save(path.join(dataDir, "output.out.xls"));

Activation des feuilles et mise en place d’une cellule active dans la feuille de calcul

Parfois, vous avez besoin qu’une feuille de calcul spécifique soit active et affichée lorsque l’utilisateur ouvre un fichier Microsoft Excel dans Excel. De même, vous pourriez vouloir activer une cellule spécifique et régler les barres de défilement pour montrer cette cellule active. Aspose.Cells est capable d’effectuer toutes ces tâches.

Une feuille active est une feuille sur laquelle vous travaillez : le nom de la feuille active sur l’onglet est en gras par défaut.

Une cellule active est une cellule sélectionnée, la cellule dans laquelle les données sont saisies lorsque vous commencez à taper. Une seule cellule est active à la fois. La cellule active est mise en évidence par une bordure épaisse.

Activation des feuilles et mise en avant d’une cellule

Aspose.Cells fournit des appels API spécifiques pour activer une feuille et une cellule. Par exemple, la propriété WorksheetCollection.getActiveSheetIndex() est utile pour définir la feuille active dans un classeur. De même, la propriété Worksheet.getActiveCell() est utilisée pour définir et obtenir une cellule active dans la feuille de calcul.

Pour vous assurer que les barres de défilement horizontales ou verticales soient à la position d’index de ligne et de colonne que vous souhaitez pour afficher des données spécifiques, utilisez les propriétés Worksheet.getFirstVisibleRow() et Worksheet.getFirstVisibleColumn().

L’exemple suivant montre comment activer une feuille de calcul et mettre en avant une cellule active. Dans la sortie générée, les barres de défilement seront scrollées pour que la 2ème ligne et la 2ème colonne soient leur première ligne et colonne visibles.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Instantiate a new Workbook.
const workbook = new AsposeCells.Workbook();

// Add a worksheet if collection is empty
const worksheets = workbook.getWorksheets();
if (worksheets.getCount() === 0) {
worksheets.add();
}

// Get the first worksheet in the workbook.
const worksheet1 = worksheets.get(0);

// Get the cells in the worksheet.
const cells = worksheet1.getCells();

// Input data into B2 cell.
cells.get(1, 1).putValue("Hello World!");

// Set the first sheet as an active sheet.
workbook.getWorksheets().setActiveSheetIndex(0);

// Set B2 cell as an active cell in the worksheet.
worksheet1.setActiveCell("B2");

// Set the B column as the first visible column in the worksheet.
worksheet1.setFirstVisibleColumn(1);

// Set the 2nd row as the first visible row in the worksheet.
worksheet1.setFirstVisibleRow(1);

// Save the excel file.
workbook.save(path.join(dataDir, "output.xls"));

Sujets avancés

Gérer les propriétés du document avec Node.js via C++ Mettre en forme les lignes et colonnes avec Node.js via C++