Установка заголовков и нижних колонтитулов

Настройка колонтитулов и подвалов

Aspose.Cells для Python via .NET позволяет добавлять заголовки и нижние колонтитулы в листы во время выполнения, но мы рекомендуем вручную задавать заголовки и нижние колонтитулы в заранее подготовленном файле для печати. Вы можете использовать Microsoft Excel в качестве графического интерфейса для установки заголовков и нижних колонтитулов, чтобы сэкономить усилия и время разработки. Aspose.Cells для Python via .NET может импортировать файл и сохранять настройки.

Для добавления заголовков и нижних колонтитулов во время выполнения, Aspose.Cells для Python via .NET предоставляет специальные вызовы API и команды скрипта для форматирования заголовков и нижних колонтитулов.

Скриптовые команды

Команды сценариев - это специальные команды, которые позволяют задавать форматирование верхних и нижних колонтитулов.

Сценарные команды Описание
&P Текущий номер страницы
&G Картинка
&N Общее количество страниц
&D Текущая дата
&T Текущее время
&A Имя листа
&F Имя файла без пути
&"<FontName>" Представляет имя шрифта. Например: &“Arial”
&"<FontName>, <FontStyle>" Представляет имя шрифта со стилем. Например: &“Arial,Bold”
&<FontSize> Представляет размер шрифта. Например: “&14abc”. Однако, если за этой командой следует обычное число для печати в заголовке, его следует отделить пробелом от размера шрифта. Например: “&14 123”.

Как установить заголовки и нижние колонтитулы

Класс PageSetup предоставляет два метода, set_header и set_footer, используемых для добавления заголовка и колонтитула в лист. Эти методы принимают только два параметра:

  • Раздел - раздел, куда следует поместить заголовок или колонтитул. Существуют три раздела: слева, по центру и справа, представленные соответственно 0, 1 и 2.
  • Сценарий - сценарий, используемый для заголовка или колонтитула. В этом сценарии содержатся команды сценариев для форматирования заголовков или колонтитулов.
from aspose.cells import Workbook
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
# Instantiating a Workbook object
excel = Workbook()
# Obtaining the reference of the PageSetup of the worksheet
pageSetup = excel.worksheets[0].page_setup
# Setting worksheet name at the left section of the header
pageSetup.set_header(0, "&A")
# Setting current date and current time at the centeral section of the header
# and changing the font of the header
pageSetup.set_header(1, "&\"Times New Roman,Bold\"&D-&T")
# Setting current file name at the right section of the header and changing the
# font of the header
pageSetup.set_header(2, "&\"Times New Roman,Bold\"&12&F")
# Setting a string at the left section of the footer and changing the font
# of a part of this string ("123")
pageSetup.set_footer(0, "Hello World! &\"Courier New\"&14 123")
# Setting the current page number at the central section of the footer
pageSetup.set_footer(1, "&P")
# Setting page count at the right section of footer
pageSetup.set_footer(2, "&N")
# Save the Workbook.
excel.save("SetHeadersAndFooters_out.xls")

Как вставить изображение в заголовок или нижний колонтитул

Класс PageSetup имеет два дополнительных метода, set_header_picture и set_footer_picture, используемых для добавления изображений в заголовок и колонтитул. Эти методы принимают параметры:

  • Секция - раздел заголовка или колонтитула, в который будет помещено изображение. Существуют три секции: слева, по центру и справа, представленные значениями 0, 1 и 2 соответственно.
  • Массив байтов - графические данные (двоичные данные должны быть записаны в буфер массива байтов).

После выполнения нижеприведенного кода и открытия файла проверьте заголовок листа:

  1. На меню Файл выберите Настройка страницы. Будет отображено диалоговое окно.
  2. Выберите вкладку Шапка/Нижний колонтитул.
from aspose.cells import Workbook
import bytearray
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
# The path to the documents directory.
dataDir = RunExamples.GetDataDir(".")
# Creating a Workbook object
workbook = Workbook()
# Creating a string variable to store the url of the logo/picture
logo_url = dataDir + "aspose-logo.jpg"
# Creating the instance of the FileStream object to open the logo/picture in the stream
inFile = open(logo_url, "rb")
# Instantiating the byte array of FileStream object's size
binaryData = bytearray(utils.filesize(inFile))
# Reads a block of bytes from the stream and writes data in a given buffer of byte array.
bytesRead = inFile.readinto(binaryData)
# Creating a PageSetup object to get the page settings of the first worksheet of the workbook
pageSetup = workbook.worksheets[0].page_setup
# Setting the logo/picture in the central section of the page header
pageSetup.set_header_picture(1, binaryData)
# Setting the script for the logo/picture
pageSetup.set_header(1, "&G")
# Setting the Sheet's name in the right section of the page header with the script
pageSetup.set_header(2, "&A")
# Saving the workbook
workbook.save(dataDir + "InsertImageInHeaderFooter_out.xls")
# Closing the FileStream object
inFile.close()