Управление разрывами страниц с помощью Node.js через C++

Согласно определению, перерыв страницы - это место в текучем тексте, где заканчивается одна страница, и начинается другая. Microsoft Excel позволяет пользователям добавлять перерывы страницы в любую выбранную ячейку листа.

Местоположение ячейки, в которую добавлен перерыв страницы, страница заканчивается, и оставшиеся данные после перерыва странице печатаются на следующей странице во время печати. Проще говоря, перерывы страницы делят ваш лист на несколько страниц в соответствии с вашими спецификациями. Вы также можете добавлять перерывы страниц в свои листы во время выполнения с использованием Aspose.Cells. Aspose.Cells позволяет разработчикам добавлять два вида перерывов страницы:

• Горизонтальный перерыв страницы
• Вертикальный перерыв страницы

В остальной части обсуждения мы опишем, как вы можете добавить горизонтальные или вертикальные перерывы страниц в свои листы с использованием Aspose.Cells.

Разрывы страниц

Aspose.Cells предоставляет класс Workbook, представляющий файл Excel. Класс Workbook содержит коллекцию Workbook.getWorksheets(), позволяющую получить доступ к каждому листу в файле Excel.

Лист представлен классом Worksheet. Класс Worksheet предоставляет широкий спектр свойств и методов, используемых для управления листом.

Для добавления перерывов страниц используйте свойства класса Worksheet и методы Worksheet.getHorizontalPageBreaks() и Worksheet.getVerticalPageBreaks().

Свойства Worksheet.getHorizontalPageBreaks() и Worksheet.getVerticalPageBreaks() являются коллекциями, которые могут содержать несколько перерывов страницы. Каждая коллекция содержит несколько методов для управления горизонтальными и вертикальными перерывами страниц.

Добавление разрывов страниц

Чтобы добавить разрыв страницы в лист, вставьте вертикальные и горизонтальные разрывы страниц в указанную ячейку, вызвав методы HorizontalPageBreakCollection.add(number, number, number) и VerticalPageBreakCollection.add(number, number, number). Каждый метод add принимает название ячейки, в которую необходимо вставить разрыв.

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

В режиме предварительного просмотра разрывов страниц или предварительного просмотра печати можно увидеть, как работают эти разрывы страниц.

Удаление определенного разрыва страницы

Чтобы удалить конкретный разрыв страницы, вызовите методы HorizontalPageBreakCollection.removeAt(number) и VerticalPageBreakCollection.removeAt(number). Каждый метод removeAt принимает индекс разрыва страницы, который необходимо удалить.

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

Важно знать

Когда вы устанавливаете свойства fitToPages (то есть PageSetup.getFitToPagesTall() и PageSetup.getFitToPagesWide()) в настройках разметки страницы, настройки разрывов страниц оказывают влияние, поэтому при печати листа настройки разрывов страниц не учитываются, хотя они все еще установлены.