Gestion des sauts de page

Un saut de page est un endroit dans le texte où une page se termine et la suivante commence. Microsoft Excel peut ajouter des sauts de page à n’importe quelle cellule sélectionnée dans une feuille de calcul. La page se termine à la cellule où le saut de page est ajouté et toutes les données après le saut de page sont imprimées sur la page suivante. En termes simples, les sauts de page divisent les feuilles de calcul en plusieurs pages. Il est également possible d’ajouter des sauts de page aux feuilles de calcul lors de l’exécution à l’aide de Aspose.Cells. Aspose.Cells prend en charge deux types de saut de page :

• horizontal
• vertical.

Cet article explique comment ajouter des sauts de page horizontaux ou verticaux dans des feuilles de calcul à l’aide de Aspose.Cells.

Aspose.Cells et sauts de page

Aspose.Cells fournit une classe,Cahier qui représente un fichier Excel. LeCahier classe contient unWorksheetCollectionqui permet d’accéder à chaque feuille de calcul dans le fichier Excel.

Une feuille de calcul est représentée par leFeuille de travailclasse qui fournit un large éventail de propriétés et de méthodes pour gérer les feuilles de calcul. Pour ajouter des sauts de page, utilisez leFeuille de travail classe'Sauts de page horizontaux etSauts de page verticauxPropriétés.

LeSauts de page horizontaux etSauts de page verticauxLes propriétés sont en fait des collections pouvant contenir plusieurs sauts de page. Chaque collection contient plusieurs méthodes de gestion des sauts de page horizontaux et verticaux. La façon dont ces méthodes sont utilisées est discutée ci-dessous.

Ajouter des sauts de page

Pour ajouter un saut de page dans une feuille de calcul, insérez des sauts de page verticaux et horizontaux dans la cellule spécifiée en appelant la commandeSauts de page horizontaux etSauts de page verticaux collections'Ajouter méthodes. ChaqueAjouterprend le nom de la cellule où le saut de page doit être ajouté.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
String dataDir = Utils.getSharedDataDir(AddingPageBreaks.class) + "worksheets/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Add a page break at cell Y30
WorksheetCollection worksheets = workbook.getWorksheets();
Worksheet worksheet = worksheets.get(0);
HorizontalPageBreakCollection hPageBreaks = worksheet.getHorizontalPageBreaks();
hPageBreaks.add("Y30");
VerticalPageBreakCollection vPageBreaks = worksheet.getVerticalPageBreaks();
vPageBreaks.add("Y30");

Dans les modes d’aperçu des sauts de page ou d’aperçu avant impression, vous pouvez voir comment ces sauts de page fonctionnent.

Effacer tous les sauts de page

Pour effacer tous les sauts de page dans une feuille de calcul, appelez leHorizontalPageBreakCollectionHorizontalPageBreakCollection etVerticalPageBreakCollection collections'Dégagerméthodes.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
String dataDir = Utils.getSharedDataDir(AddingPageBreaks.class) + "worksheets/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
workbook.getWorksheets().get(0).getHorizontalPageBreaks().clear();
workbook.getWorksheets().get(0).getVerticalPageBreaks().clear();

Suppression d’un saut de page spécifique

Pour supprimer un saut de page spécifique dans la feuille de calcul, appelez leHorizontalPageBreakCollectionHorizontalPageBreakCollection etVerticalPageBreakCollection collections'removeAt méthodes. ChaqueremoveAtprendra l’index du saut de page à supprimer.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
String dataDir = Utils.getSharedDataDir(RemoveSpecificPageBreak.class) + "worksheets/";
// Instantiating a Workbook object
Workbook workbook = new Workbook(dataDir + "SampleXLSFile_38kb.xls");

// Removing a specific page break
WorksheetCollection worksheets = workbook.getWorksheets();
Worksheet worksheet = worksheets.get(0);
HorizontalPageBreakCollection hPageBreaks = worksheet.getHorizontalPageBreaks();
hPageBreaks.removeAt(0);
VerticalPageBreakCollection vPageBreaks = worksheet.getVerticalPageBreaks();
vPageBreaks.removeAt(0);

Important à savoir : lorsque vous définissez les propriétés d’ajustement à la page (c’est-à-direFitToPagesTall etFitToPagesWide) dans les paramètres de mise en page, les paramètres de saut de page sont affectés. Par conséquent, si vous imprimez la feuille de calcul, les paramètres de saut de page ne sont pas pris en compte bien qu’ils existent toujours dans le fichier.