Функции настройки страницы
Иногда необходимо настроить параметры настройки страницы для листов, чтобы контролировать печать. Эти параметры настройки страницы предлагают различные варианты.
Опции страницы
Опции настройки страницы полностью поддерживаются в Aspose.Cells. В этой статье объясняется, как установить опции страницы с помощью Aspose.Cells.
Настройка параметров страницы
Aspose.Cells предоставляет класс Workbook, который представляет файл Microsoft Excel. Класс Workbook содержит коллекцию Worksheets, которая позволяет получить доступ к каждому листу в файле Excel. Лист представлен классом Worksheet.
Класс Worksheet предоставляет свойство PageSetup, используемое для установки параметров настройки страницы. Фактически, свойство PageSetup является объектом класса PageSetup, что позволяет устанавливать параметры макета страницы для печатного листа. Класс PageSetup предоставляет различные свойства, используемые для установки параметров настройки страницы. Некоторые из этих свойств обсуждаются ниже.
Ориентация страницы
Ориентацию страницы можно установить в книжный или альбомный вид с помощью метода setOrientation(PageOrientationType) класса PageSetup. Метод setOrientation(PageOrientationType) принимает перечисление PageOrientationType в качестве параметра. Члены перечисления PageOrientationType перечислены ниже.
| Типы ориентации страницы | Описание |
|---|---|
| LANDSCAPE | Альбомная ориентация |
| PORTRAIT | Книжная ориентация |
Фактор масштабирования
Размер листа можно уменьшить или увеличить, отрегулировав фактор масштабирования с помощью метода setZoom класса PageSetup.
Опции FitToPages
Чтобы подогнать содержимое листа под определенное количество страниц, используйте методы setFitToPagesTall и setFitToPagesWide класса PageSetup. Эти методы также используются для масштабирования листов.
Размер бумаги
Установите размер бумаги, на который будут напечатаны листы, с помощью свойства PaperSize класса PageSetup. Свойство PaperSize принимает одно из предопределенных значений в перечислении PaperSizeType, перечисленных ниже.
| Типы размеров бумаги | Описание |
|---|---|
| Paper10x14 | 10 in. x 14 in. |
| Paper11x17 | 11 in. x 17 in. |
| PaperA3 | A3 (297 mm x 420 mm) |
| PaperA4 | A4 (210 mm x 297 mm) |
| PaperA4Small | A4 Small (210 mm x 297 mm) |
| PaperA5 | A5 (148 mm x 210 mm) |
| PaperB3 | B3 (13.9 x 19.7 inches) |
| PaperB4 | B4 (250 mm x 354 mm) |
| PaperB5 | B5 (182 mm x 257 mm) |
| PaperBusinessCard | Business Card (90 mm x 55 mm) |
| PaperCSheet | C size sheet |
| PaperDSheet | D size sheet |
| PaperEnvelope10 | Envelope #10 (4-1/8 in. x 9-1/2 in.) |
| PaperEnvelope11 | Envelope #11 (4-1/2 in. x 10-3/8 in.) |
| PaperEnvelope12 | Envelope #12 (4-1/2 in. x 11 in.) |
| PaperEnvelope14 | Envelope #14 (5 in. x 11-1/2 in.) |
| PaperEnvelope9 | Envelope #9 (3-7/8 in. x 8-7/8 in.) |
| PaperEnvelopeB4 | Envelope B4 (250 mm x 353 mm) |
| PaperEnvelopeB5 | Envelope B5 (176 mm x 250 mm) |
| PaperEnvelopeB6 | Envelope B6 (176 mm x 125 mm) |
| PaperEnvelopeC3 | Envelope C3 (324 mm x 458 mm) |
| PaperEnvelopeC4 | Envelope C4 (229 mm x 324 mm) |
| PaperEnvelopeC5 | Envelope C5 (162 mm x 229 mm) |
| PaperEnvelopeC6 | Envelope C6 (114 mm x 162 mm) |
| PaperEnvelopeC65 | Envelope C65 (114 mm x 229 mm) |
| PaperEnvelopeDL | Envelope DL (110 mm x 220 mm) |
| PaperEnvelopeItaly | Envelope Italy (110 mm x 230 mm) |
| PaperEnvelopeMonarch | Envelope Monarch (3-7/8 in. x 7-1/2 in.) |
| PaperEnvelopePersonal | Envelope (3-5/8 in. x 6-1/2 in.) |
| PaperESheet | E size sheet |
| PaperExecutive | Executive (7-1/2 in. x 10-1/2 in.) |
| PaperFanfoldLegalGerman | German Legal Fanfold (8-1/2 in. x 13 in.) |
| PaperFanfoldStdGerman | German Standard Fanfold (8-1/2 in. x 12 in.) |
| PaperFanfoldUS | U.S. Standard Fanfold (14-7/8 in. x 11 in.) |
| PaperFolio | Folio (8-1/2 in. x 13 in.) |
| PaperLedger | Ledger (17 in. x 11 in.) |
| PaperLegal | Legal (8-1/2 in. x 14 in.) |
| PaperLetter | Letter (8-1/2 in. x 11 in.) |
| PaperLetterSmall | Letter Small (8-1/2 in. x 11 in.) |
| PaperNote | Note (8-1/2 in. x 11 in.) |
| PaperQuarto | Quarto (215 mm x 275 mm) |
| PaperStatement | Statement (5-1/2 in. x 8-1/2 in.) |
| PaperTabloid | Tabloid (11 in. x 17 in.) |
Качество печати
Установите качество печати листов, которые будут напечатаны с помощью метода setPrintQuality класса PageSetup. Единица измерения качества печати - точки на дюйм (DPI).
Номер первой страницы
Начните нумерацию страниц листа с использованием метода setFirstPageNumber класса PageSetup. Метод setFirstPageNumber устанавливает номер страницы первой страницы листа, и следующие страницы нумеруются по возрастанию.
Установка полей
Aspose.Cells полностью поддерживает параметры настройки страниц Microsoft Excel. Разработчики могут настраивать параметры страницы для листов, чтобы контролировать процесс печати. В данном разделе рассматривается, как использовать Aspose.Cells для настройки полей страницы.
Поля страниц в Microsoft Excel
Aspose.Cells предоставляет класс Workbook, который представляет собой файл Microsoft Excel. Класс Workbook содержит коллекцию листов, позволяющую получить доступ к каждому листу в файле Excel. Лист представлен классом Worksheet.
Класс Worksheet предоставляет свойство PageSetup, используемое для установки параметров настройки страницы. Атрибут PageSetup представляет объект класса PageSetup, который позволяет установить различные параметры макета страницы для напечатанного листа. Класс PageSetup предоставляет различные свойства и методы, используемые для установки параметров страницы.
Поля страницы
Установите поля (левое, правое, верхнее, нижнее) страницы с помощью членов класса PageSetup. Ниже приведены некоторые методы, используемые для указания полей страницы:
Центрирование на странице
Возможно центрирование чего-либо на странице горизонтально и вертикально. У класса PageSetup есть члены для этой цели: setCenterHorizontally и setCenterVertically.
Поля верхнего и нижнего колонтитулов
Установите поля верхних и нижних колонтитулов с помощью членов класса PageSetup, таких как setHeaderMargin и setFooterMargin.
Настройка колонтитулов и подвалов
Верхние и нижние колонтитулы - это разделы текста и изображений над верхним полем или под нижним полем страницы. Также возможно добавление верхних и нижних колонтитулов к листам. Верхние и нижние колонтитулы могут использоваться для отображения любой полезной информации, например номера страницы, имени автора, заголовка документа или даты и времени. Верхние и нижние колонтитулы также управляются с помощью диалогового окна настройки страницы.
Диалоговое окно настройки страницы
Aspose.Cells позволяет добавлять верхние и нижние колонтитулы к листам во время выполнения, но рекомендуется устанавливать верхние и нижние колонтитулы вручную в предварительно разработанном файле для печати. Вы можете использовать Microsoft Excel в качестве инструмента с графическим интерфейсом пользователя для удобной установки верхних и нижних колонтитулов, чтобы уменьшить время разработки. Aspose.Cells может импортировать файл и сохранить эти настройки.
Чтобы добавлять верхние и нижние колонтитулы во время выполнения, Aspose.Cells предоставляет специальные классы и некоторые команды для управления форматированием.
Скриптовые команды
Сценарные команды - это специальные команды, предоставляемые Aspose.Cells, позволяющие разработчикам форматировать заголовки и нижние колонтитулы.
| Сценарные команды | Описание |
|---|---|
| &P | Текущий номер страницы. |
| &G | Изображение. |
| &N | Общее количество страниц. |
| &D | Текущая дата. |
| &T | Текущее время. |
| &A | Имя листа. |
| &F | Имя файла без пути. |
| &"<FontName>" | Имя шрифта. Например: &“Arial” |
| &"<FontName>, <FontStyle>" | Имя шрифта с начертанием. Например: &“Arial,Bold” |
| &<FontSize> | Представляет размер шрифта. Например: “&14abc”. Однако, если за этой командой следует обычное число для печати в заголовке, его следует отделить пробелом от размера шрифта. Например: “&14 123”. |
Установить заголовки и нижние колонтитулы
Класс PageSetup предоставляет метод setHeader для добавления заголовка и setFooter для добавления нижнего колонтитула на лист. Этот сценарий используется в качестве аргумента для всех вышеупомянутых методов. Он представляет сценарий, используемый для заголовка или нижнего колонтитула. Этот скрипт содержит команды скрипта для форматирования заголовков или колонтитулов.
Вставить графику в заголовок или нижний колонтитул
Класс PageSetup имеет методы setHeadPicture и setFooterPicture для добавления изображений в заголовок и нижний колонтитул листа. Эти методы принимают два параметра:
- Секция, секция заголовка или нижнего колонтитула, куда будет размещено изображение. Есть три секции: слева, центр и справа, представленные числовыми значениями 0, 1 и 2 соответственно.
- Поток файла, графические данные. Бинарные данные должны быть записаны в буфер байтового массива.
После выполнения кода и открытия файла проверьте заголовок листа в Microsoft Excel:
- В меню Файл выберите Настройка страницы.
- В диалоговом окне настройки страницы выберите вкладку Верхний колонтитул/нижний колонтитул.
Вставка графики в верхний/нижний колонтитул
Вставка графики только вверхний колонтитул первой страницы
Класс PageSetup также имеет другие полезные методы, например setPicture, setFirstPageHeader, setFirstPageFooter, для добавления изображений в верхний и нижний колонтитул первой страницы листа. Первая страница является особой страницей: часто требуется, чтобы она показывала специальную информацию, например логотип компании.
Установка параметров печати
Настройки страницы в Microsoft Excel предоставляют несколько параметров печати (также называемых параметры листа), которые позволяют пользователям контролировать, как будут напечатаны страницы рабочего листа. Эти параметры печати позволяют пользователям:
- Выбрать конкретную область печати на рабочем листе.
- Напечатать заголовки.
- Напечатать сетку.
- Напечатать заголовки строк и столбцов.
- Достичь чернового качества.
- Напечатать примечания.
- Напечатать ошибки ячеек.
- Определить порядок страниц.
Ниже показаны все эти параметры печати.
Параметры печати (листа)
Настройка параметров печати и листа
spose.Cells поддерживает все параметры печати, предлагаемые Microsoft Excel, и разработчики могут легко настроить эти параметры для рабочих листов, используя свойства, предлагаемые классом PageSetup. О том, как используются эти свойства, обсуждается ниже более подробно.
Установка области печати
По умолчанию область печати включает все области рабочего листа, содержащие данные. Разработчики могут определить конкретную область печати для рабочего листа.
Чтобы выбрать конкретную область печати, используйте свойство setPrintArea класса PageSetup. Назначьте этому свойству диапазон ячеек, определяющий область печати.
Установка заголовков для печати
Aspose.Cells позволяет назначить заголовки строк и столбцов для повторения на всех страницах напечатанного листа. Для этого используйте свойства setPrintTitleColumns и setPrintTitleRows класса PageSetup.
Строки или столбцы, которые будут повторяться, определяются путем передачи их номеров строки или столбца. Например, строки определяются как $1:$2, а столбцы определяются как $A:$B.
Настройка Других Опций Печати
Класс PageSetup также предоставляет несколько других свойств для установки общих параметров печати следующим образом:
- setPrintGridlines, логическое свойство, определяющее, следует ли печатать сетку или нет.
- setPrintHeadings, логическое свойство, определяющее, следует ли печатать заголовки строк и столбцов или нет.
- setBlackAndWhite, логическое свойство, определяющее, следует ли печатать лист в черно-белом режиме или нет.
- setPrintComments, определяет, следует ли отображать примечания к печати на листе или в конце листа.
- setPrintDraft, логическое свойство, определяющее, следует ли печатать лист в черновом режиме или нет.
- setPrintErrors, определяет, следует ли печатать ошибки ячеек так, как они отображаются, в виде пустоты, тире или N/A.
Для установки свойств PrintComments и PrintErrors, Aspose.Cells также предоставляет два перечисления, PrintCommentsType и PrintErrorsType, которые содержат предопределенные значения для назначения свойствам setPrintComments и setPrintErrors соответственно.
Предопределенные значения в перечислении PrintCommentsType описаны ниже.
| Типы Примечаний к Печати | Описание |
|---|---|
| PRINT_IN_PLACE | Указывает на печать примечаний в виде их отображения на листе. |
| PRINT_NO_COMMENTS | Указывает не печатать примечания. |
| PRINT_SHEET_END | Указывает печатать примечания в конце листа. |
Предопределенные значения перечисления PrintErrorsType описаны ниже.
| Типы Ошибок Печати | Описание |
|---|---|
| PRINT_ERRORS_BLANK | Указывает, что ошибки не следует печатать. |
| PRINT_ERRORS_DASH | Указывает, что ошибки следует печатать как “–”. |
| PRINT_ERRORS_DISPLAYED | Указывает, что ошибки следует печатать как отображаемые. |
| PRINT_ERRORS_NA | Указывает, что ошибки следует печатать как “#N/A”. |
Установить порядок страниц
Класс PageSetup предоставляет свойство setOrder, которое используется для упорядочения печати нескольких страниц вашей рабочей книги. Существует два варианта упорядочивания страниц, как показано ниже:
- Сначала вниз, затем вправо печатает все страницы внизу перед печатью страниц справа.
- Сначала вправо, затем вниз печатает страницы слева направо перед печатью страниц снизу.
Aspose.Cells предоставляет перечисление PrintOrderType, которое содержит все заранее определенные типы порядка для назначения методу setOrder.
Заранее определенные значения перечисления PrintOrderType описаны ниже.
| Типы порядка печати | Описание |
|---|---|
| DOWN_THEN_OVER | Печать сверху вниз, затем вправо. |
| OVER_THEN_DOWN | Печать слева направо, затем вниз. |
Удаление текущих настроек принтера на листах Excel
Пожалуйста, ознакомьтесь с этой статьей по этой теме.
Продвинутые темы
- Вычислить масштабирование настройки страницы
- Копирование настроек страницы с исходного листа на целевой лист
- Определение автоматического размера бумаги листа
- Получение ширины и высоты бумаги из настройки страницы листа
- Настройка пользовательского размера бумаги для отображения на листе
- Настройки страницы и опции печати
- Удаление текущих настроек принтера на листах Excel