Настройка верхних и нижних колонтитулов

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

Настройка верхних и нижних колонтитулов

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

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

Команды сценария

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

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

Установить верхние и нижние колонтитулы

Настройка страницы класс предоставляет два метода,SetHeader иSetFooter, используемый для добавления верхнего и нижнего колонтитула на лист. Эти методы принимают только два параметра:

• Раздел – раздел, в котором должен быть размещен верхний или нижний колонтитул. Есть три секции: левая, центральная и правая, обозначенные цифрами 0, 1 и 2 соответственно.
• Скрипт – сценарий, который будет использоваться для верхнего или нижнего колонтитула. Этот сценарий содержит команды сценария для форматирования верхних или нижних колонтитулов.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET

// Instantiating a Workbook object
Workbook excel = new Workbook();

// Obtaining the reference of the PageSetup of the worksheet
PageSetup pageSetup = excel.Worksheets[0].PageSetup;

// Setting worksheet name at the left section of the header
pageSetup.SetHeader(0, "&A");

// Setting current date and current time at the centeral section of the header
// and changing the font of the header
pageSetup.SetHeader(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.SetHeader(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.SetFooter(0, "Hello World! &\"Courier New\"&14 123");

// Setting the current page number at the central section of the footer
pageSetup.SetFooter(1, "&P");

// Setting page count at the right section of footer
pageSetup.SetFooter(2, "&N");

// Save the Workbook.
excel.Save("SetHeadersAndFooters_out.xls");

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

Настройка страницы класс имеет два дополнительных метода,SetHeaderPicture иSetFooterPicture, используемый для добавления изображений в верхний и нижний колонтитулы. Эти методы принимают параметры:

• Раздел– раздел верхнего или нижнего колонтитула, где будет размещено изображение. Есть три секции, левая, центральная и правая, представленные значениями 0, 1 и 2 соответственно.
• Байтовый массив – графические данные (двоичные данные должны быть записаны в буфер байтового массива).

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

1. НаФайл меню, выберитеНастройка страницы. Отобразится диалоговое окно.
2. ВыберитеВерхний/нижний колонтитул вкладка

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Creating a Workbook object
Workbook workbook = new Workbook();

// Creating a string variable to store the url of the logo/picture
string logo_url = dataDir + "aspose-logo.jpg";

// Declaring a FileStream object
FileStream inFile;

// Declaring a byte array
byte[] binaryData;

// Creating the instance of the FileStream object to open the logo/picture in the stream
inFile = new System.IO.FileStream(logo_url, System.IO.FileMode.Open, System.IO.FileAccess.Read);

// Instantiating the byte array of FileStream object's size
binaryData = new Byte[inFile.Length];

// Reads a block of bytes from the stream and writes data in a given buffer of byte array.
long bytesRead = inFile.Read(binaryData, 0, (int)inFile.Length);

// Creating a PageSetup object to get the page settings of the first worksheet of the workbook
PageSetup pageSetup = workbook.Worksheets[0].PageSetup;

// Setting the logo/picture in the central section of the page header
pageSetup.SetHeaderPicture(1, binaryData);

// Setting the script for the logo/picture
pageSetup.SetHeader(1, "&G");

// Setting the Sheet's name in the right section of the page header with the script
pageSetup.SetHeader(2, "&A");

// Saving the workbook
workbook.Save(dataDir + "InsertImageInHeaderFooter_out.xls");

//Closing the FileStream object
inFile.Close();