Управление разрывами страниц
Разрыв страницы — это место в тексте, где заканчивается одна страница, и начинается следующая. В Microsoft Excel можно добавить разрывы страниц в любую выбранную ячейку на листе. Страница заканчивается на ячейке, в которой добавлен разрыв страницы, и все данные после разрыва печатаются на следующей странице. Проще говоря, разрывы страниц разделяют листы на несколько страниц. Также возможно добавление разрывов страниц на листы во время выполнения с помощью Aspose.Cells. Aspose.Cells поддерживает два вида разрывов страниц:
- горизонтальный
- вертикальный.
В данной статье описывается, как добавлять горизонтальные или вертикальные разрывы страниц в листы с помощью Aspose.Cells.
Aspose.Cells и разрывы страниц
Aspose.Cells предоставляет класс, Workbook, который представляет собой файл Excel. Класс Workbook содержит WorksheetCollection, позволяющий получить доступ к каждому листу в файле Excel.
Лист представлен классом Worksheet, который предоставляет широкий набор свойств и методов для управления листами. Чтобы добавить разрывы страниц, используйте свойства HorizontalPageBreaks и VerticalPageBreaks класса Worksheet.
Свойства {0} и {1] фактически являются коллекциями, которые могут содержать несколько разрывов страниц. Каждая коллекция содержит несколько методов для управления горизонтальными и вертикальными разрывами страниц. Как использовать эти методы, рассматривается ниже.
Добавление разрывов страниц
Чтобы добавить разрыв страницы на листе, вставьте вертикальный и горизонтальный разрывы в указанную ячейку, вызвав методы Add коллекций HorizontalPageBreaks и VerticalPageBreaks. Каждый метод Add принимает имя ячейки, в которой нужно добавить разрыв страницы.
| // 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"); |
Очистка всех разрывов страниц
Для очистки всех разрывов страниц на листе вызовите методы Clear коллекций HorizontalPageBreakCollection и VerticalPageBreakCollection.
| // 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(); |
Удаление определенного разрыва страницы
Для удаления определенного разрыва страницы на листе вызовите методы removeAt коллекций HorizontalPageBreakCollection и VerticalPageBreakCollection. Каждый метод removeAt примет индекс разрыва страницы, который нужно удалить.
| // 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); |