Документация

Верхние колонтитулы страницы и нижние колонтитулы, одним словом, обрабатывают по шаблону

Каждая страница, одним словом, документирует, имеет заголовок и нижний колонтитул, который можно отредактировать. Чтобы включить режим редактирования, дважды кликните заголовок или область нижнего колонтитула. Также на вкладке Word Insert, в разделе Header & Footer, кликают по стрелке кнопки Header или Footer. Из меню выберите соответствующую команду Edit. Когда вы закончите редактировать заголовок или нижний колонтитул на вкладке Header & Footer Tools Design, нажмите Close Header and Footer.

В режиме редактирования можно изменить заголовок или нижний колонтитул:

Для получения дополнительной информации о работе с верхними колонтитулами страницы Word и нижними колонтитулами, см. документацию Word.

Можно изменить верхние колонтитулы страницы и нижние колонтитулы непосредственно в основном шаблоне. Чтобы добавить верхний колонтитул страницы или нижний колонтитул в шаблоне части документа, измените верхний колонтитул страницы и нижний колонтитул, как вы хотите. Выберите целую страницу с помощью CTRL+A, прежде чем вы сохраните часть в галерею Quick Parts. Для получения дополнительной информации при добавлении и изменении шаблонов части документа, смотрите, Создают Библиотеку шаблонов Части Документа Microsoft Word.

Можно вставить номер страницы в заголовок или нижний колонтитул. На вкладке Header & Footer Design используйте меню Page Number, чтобы вставить номер страницы. К параметрам форматирования доступа, в заголовке или нижнем колонтитуле, щелкают правой кнопкой по номеру страницы и выбирают Format Page Numbers.

Верхние колонтитулы страницы и нижние колонтитулы в шаблоне PDF

Добавление верхних колонтитулов страницы и нижних колонтитулов в шаблоне PDF включает эти шаги:

Таблица показывает атрибуты, что можно использовать с <pheader> и <pfooter>. Эти элементы соответствуют классам DOM mlreportgen.dom.PDFPageHeader и mlreportgen.dom.PDFPageFooter.

Например, этот код задает шаблон Chapter части документа, который использует два нижних колонтитула: один для нечетных страниц и один для четных страниц. Формат номера страницы является арабскими цифрами.

<dptemplate name="Chapter">
     <layout style="page-margin: 1in 1in 1in 1in 0.5in 0.5in 0in; 
						page-size: 8.5in 11in portrait">
         <pfooter type="default" template-name="MyPageFooter"/>
		     <pfooter type="even" template-name="MyEvenFooter"/>
         <pnumber format="1" />
      </layout>
<!-- Define  content for your chapter here--fixed text and holes as needed -->
</dptemplate>

Задайте шаблоны части документа MyPageFooter и MyEvenFooter в файле docpart_templates.html. Например, задайте нижние колонтитулы так, чтобы:

Эти шаблоны части документа задают нижние колонтитулы.

<dptemplate name="MyPageFooter">
    <p style="text-align:right;font-family:Arial,Helvetica,sans-serif;font-size:10pt">
    <page/></p>
</dptemplate>
<dptemplate name="MyEvenFooter">
    <p style="text-align:left;font-family:Arial,Helvetica,sans-serif;font-size:10pt">
    <page/></p>
</dptemplate>

Эти элементы HTML API DOM полезны в заголовках и нижних колонтитулах. Например, можно добавить номера страниц в заголовки и нижние колонтитулы на Странице 1 формы 3 использований <page> и <numpages>. Смотрите mlreportgen.dom.NumPages для эквивалентного программируемого подхода. Можно также сгенерировать содержимое в заголовке или нижнем колонтитуле, который изменяется на основе содержимого указанного элемента (стиль) на странице. Смотрите Создают Рабочие Верхние колонтитулы страницы и Нижние колонтитулы.

Заданные шаблоном доступа заголовки и нижние колонтитулы

Используйте свойство CurrentPageLayout объекта Document или DocumentPart получить доступ к заданным шаблоном заголовкам и нижним колонтитулам для текущего раздела части документа или документа.

Значение свойства CurrentPageLayout является объектом DOCXPageLayout или PDFPageLayout, свойства PageHeaders и PageFooters которого содержат массив ячеек объектов, соответствующих заданным шаблоном заголовкам и нижним колонтитулам текущего раздела. Каждый массив ячеек может содержать до трех объектов, в зависимости от того, сколько из трех типов заголовков и нижних колонтитулов (первая страница, четная страница, нечетная страница) вы задаете для раздела. Объекты могут появиться в любом порядке в массиве ячеек. Таким образом, чтобы получить доступ к заголовку или нижнему колонтитулу конкретного типа, ищите массив ячеек, чтобы найти тот, к которому вы хотите получить доступ.

Добавьте содержимое к заданному шаблоном заголовку или нижнему колонтитулу

Можно использовать API DOM, чтобы добавить содержимое к заданному шаблоном заголовку или нижнему колонтитулу, который появляется на каждой странице в разделе. Чтобы добавить содержимое к заголовку или нижнему колонтитулу в текущем разделе части документа или документа, сначала используйте свойство CurrentPageLayout части документа или документа получить доступ к объекту DOCX или PDF PagerHeader или PageFooter. Затем используйте метод append объекта PageHeader или PageFooter добавить содержимое.

Заголовок и объекты нижнего колонтитула являются типом объекта части документа. Можно добавить любой вид содержимого к верхнему колонтитулу страницы или нижнему колонтитулу, что можно добавить к части документа, например, абзацам, изображениям и таблицам.

Можно использовать дыры в заголовке и нижние колонтитулы основного шаблона, чтобы управлять расположением содержимого, которое вы добавляете к заголовкам и нижним колонтитулам. Например, эта программа добавляет сегодняшнюю дату к дыре под названием Date на первом заданном шаблоном верхнем колонтитуле страницы первого раздела отчета. Этот пример принимает, что шаблон Word, MyReportTemplate имеет одно размещение, которое задает первую страницу, нечетную страницу, и заголовок четной страницы и нижний колонтитул.

import mlreportgen.dom.*;
d = Document('MyReport','docx','MyReportTemplate');
open(d);

sect = d.CurrentPageLayout;

for i = 1:numel(sect.PageHeaders)
    if strcmpi(sect.PageHeaders(i).PageType,'first')
        firstPageHeader = sect.PageHeaders(i); 
        while ~strcmp(firstPageHeader.CurrentHoleId,'#end#')
            switch firstPageHeader.CurrentHoleId
                case 'Date'
                    append(firstPageHeader,date);                       
            end
            moveToNextHole(firstPageHeader);
        end
        break;
    end
end

close(d);
rptview(d.OutputPath);

Создайте рабочие верхние колонтитулы страницы и нижние колонтитулы в шаблоне

Верхние колонтитулы страницы и Нижние колонтитулы, одним словом, Шаблон описывают общий подход к редактированию верхних колонтитулов страницы и нижних колонтитулов в Word. Чтобы добавить обычный текст, вставьте поле StyleRef. Это поле эквивалентно API DOM класс mlreportgen.dom.StyleRef. Чтобы вставить это поле, одним словом, обрабатывают по шаблону или шаблон части документа:

Для документов в формате PDF, чтобы включать обычный текст, используют элемент <styleref>. Добавьте код как это к файлу библиотеки docpart_templates.html вашего шаблона. Элемент <styleref> использует объект Heading1 для содержимого по умолчанию.

<dptemplate name="RunningFooter">
    <p style="text-align:center;font-family:sans-serif;font-size:10pt">
         <styleref/>
    </p>
 </dptemplate>

Чтобы видеть эффект, добавьте нижний колонтитул в элементе <layout> файла root.html вашего шаблона. Можно вставить его в любой элемент <layout>, который задает шаблон.

<layout style="page-margin: 1in 1in 1in 1in 0.5in 0.5in 0in; 
       page-size: 8.5in 11in portrait">
       <pfooter template-name="RunningFooter" />
</layout>

Используйте код, который создает объекты Heading1 и вызывает ваш шаблон, чтобы видеть результат. Этот код принимает, что вы задали шаблон части документа нижнего колонтитула в шаблоне RunFooters.

import mlreportgen.dom.*;
d = Document('mydoc','pdf','RunFooters');
open(d);

title = append(d, Paragraph('Document Title'));
title.Bold = true;
title.FontSize = '28pt';

h1 = append(d,Heading1('My First Chapter'));
p1 = append(d,Paragraph('Hello World'));

h2 = append(d,Heading1('My Second Chapter'));
h2.Style = {PageBreakBefore(true)};
p2 = append(d,Paragraph('Text for this chapter.'));

close(d);
rptview(d.OutputPath);

Чтобы относиться к нижнему колонтитулу программно, используйте код в этой форме. Первый аргумент является типом нижнего колонтитула, вторым является пакет шаблона, и третьим является шаблон части документа.

PDFPageFooter('default','RunFooters','RunningFooter');

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

import mlreportgen.dom.*;
d = Document('mydoc','pdf','RunFooters');
open(d);

myfooter = PDFPageFooter('default','RunFooters','RunningFooter');
d.CurrentPageLayout.PageFooters = myfooter;

title = append(d,Paragraph('Document Title'));
title.Bold = true;
title.FontSize = '28pt';

h1 = append(d,Heading1('My First Chapter'));
p1 = append(d,Paragraph('Hello World'));

h2 = append(d,Heading1('My Second Chapter'));
h2.Style = {PageBreakBefore(true)};
p2 = append(d,Paragraph('Text for this chapter.'));

close(d);
rptview(d.OutputPath);

Создайте рабочие верхние колонтитулы страницы и нижние колонтитулы программно

API DOM обеспечивает классы, которые помогают вам создать рабочие заголовки и нижние колонтитулы программно в Word и документах в формате PDF.