Gestion des sauts de page avec Node.js via C++

Selon la définition, un saut de page est un endroit dans un flux de texte où une page se termine et où la page suivante commence. Microsoft Excel permet aux utilisateurs d’ajouter des sauts de page dans n’importe quelle cellule sélectionnée d’une feuille de calcul.

L’emplacement de la cellule où le saut de page est ajouté, la page se termine et le reste des données après le saut de page est imprimé sur la page suivante lors de l’impression. En termes simples, les sauts de page divisent votre feuille de calcul en plusieurs pages selon vos spécifications. Vous pouvez également ajouter des sauts de page à vos feuilles de calcul à l’exécution à l’aide d’Aspose.Cells. Aspose.Cells permet aux développeurs d’ajouter deux types de sauts de page :

• Saut de page horizontal
• Saut de page vertical

Dans le reste de la discussion, nous décrirons comment ajouter des sauts de page horizontaux ou verticaux dans vos feuilles de calcul à l’aide d’Aspose.Cells.

Sauts de page

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 du fichier Excel.

Une feuille de calcul est représentée par la classe Worksheet. La classe Worksheet fournit un large éventail de propriétés et de méthodes utilisées pour gérer une feuille de calcul.

Pour ajouter les sauts de page, utilisez les propriétés de la classe Worksheet Worksheet.getHorizontalPageBreaks() et Worksheet.getVerticalPageBreaks().

Les propriétés Worksheet.getHorizontalPageBreaks() et Worksheet.getVerticalPageBreaks() sont des collections qui peuvent contenir plusieurs sauts de page. Chaque collection contient plusieurs méthodes pour gérer les sauts de page horizontaux et verticaux.

Ajout de sauts de page

Pour ajouter un saut de page dans une feuille de calcul, insérez des sauts de page verticaux et horizontaux à la cellule spécifiée en appelant les méthodes HorizontalPageBreakCollection.add(number, number, number) et VerticalPageBreakCollection.add(number, number, number). Chaque méthode d’ajout prend le nom de la cellule où le saut doit être ajouté.

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();

// Add a page break at cell Y30
workbook.getWorksheets().get(0).getHorizontalPageBreaks().add("Y30");
workbook.getWorksheets().get(0).getVerticalPageBreaks().add("Y30");

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

En mode Aperçu des sauts de page ou Aperçu avant impression, vous pouvez voir comment fonctionnent ces sauts de page.

Suppression d’un saut de page spécifique

Pour supprimer un saut de page spécifique, appelez les méthodes HorizontalPageBreakCollection.removeAt(number) et VerticalPageBreakCollection.removeAt(number). Chaque méthode removeAt prend l’index du saut de page à supprimer.

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, "PageBreaks.xls");

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

// Removing a specific page break
workbook.getWorksheets().get(0).getHorizontalPageBreaks().removeAt(0);
workbook.getWorksheets().get(0).getVerticalPageBreaks().removeAt(0);

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

Important à savoir

Lorsque vous définissez les propriétés fitToPages (c’est-à-dire PageSetup.getFitToPagesTall() et PageSetup.getFitToPagesWide()) dans les paramètres de mise en page, les paramètres de saut de page sont affectés, donc si vous imprimez la feuille, les sauts de page ne seront pas pris en compte même s’ils sont toujours définis.