Программная настройка размера страницы и полей отчета

В этом примере показано, как использовать программный подход для настройки размера страницы и полей страницы, верхнего и нижнего колонтитулов в отчете PDF или Microsoft Word. Кроме того, можно использовать подход на основе шаблона. Примеры использования подхода, основанного на шаблонах, см. в разделах Настройка размера страницы и полей отчета Word с использованием шаблонов и Настройка размера страницы и полей отчета PDF с использованием шаблонов. Используйте подход на основе шаблона, если планируется внести другие изменения в шаблоны. В противном случае используйте программный подход.

По умолчанию интерфейс API Report генерирует страницы, имеющие 11-дюймовую высоту, 8,5-дюймовую ширину и 1-дюймовые поля. Каждый верхний и нижний колонтитулы имеет ширину 0,5 дюйма, а желоб - 0 пикселей. Возможно, потребуется изменить эти измерения в отчете. Например, при создании отчета для европейского языкового стандарта может потребоваться создание A4 страниц с высотой 11,69 дюйма, шириной 8,27 дюйма и полями 0,98 дюйма.

Для программной настройки размеров страниц отчета API Report назначьте пользовательские mlreportgen.dom.PageSize и mlreportgen.dom.PageMargins объектов к объекту макета, используемому для всего отчета или раздела отчета. Объект формата для всего отчета является mlreportgen.report.ReportLayout объект, который назначен Layout имущества mlreportgen.report.Report объект. Формат раздела отчета представляет собой mlreportgen.report.ReporterLayout объект, который назначен Layout свойство объекта reporter, представляющего раздел. Объекты этих репортерских классов имеют Layout свойство, которое можно использовать для настройки размеров страницы для раздела:

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

В этом примере создается отчет, который имеет A4 размеры страницы, а затем переопределяет эти размеры для страницы заголовка.

import mlreportgen.dom.*;
import mlreportgen.report.*;

rpt = mlreportgen.report.Report("myreport","docx");

pageSizeObj = PageSize("11.69in","8.27in","portrait");
rpt.Layout.PageSize = pageSizeObj;

pageMarginsObj = PageMargins();
pageMarginsObj.Top = "0.98in";
pageMarginsObj.Bottom = "0.98in";
pageMarginsObj.Left = "0.98in";
pageMarginsObj.Right = "0.98in";
pageMArginsObj.Header = "0.5in";
pageMarginsObj.Footer = "0.5in";
pageMarginsObj.Gutter = "0in";

rpt.Layout.PageMargins = pageMarginsObj;

title = TitlePage("Title","Magic Squares");
title.Subtitle = "Columns, Rows, Diagonals: All Equal Sums";
title.Author = "Albrecht Durer"; 
pageMarginsObj = PageMargins();
pageMarginsObj.Top = "2in";
pageMarginsObj.Bottom = "2in";
pageMarginsObj.Left = "2in";
pageMarginsObj.Right = "2in";
pageMArginsObj.Header = "0.5in";
pageMarginsObj.Footer = "0.5in";
pageMarginsObj.Gutter = "0in";

title.Layout.PageMargins = pageMarginsObj;
append(rpt,title);

toc = TableOfContents;
append(rpt,toc);

chapter = Chapter("Introduction"); 

sec1 = Section("What is a Magic Square?"); 
para = Paragraph(['A magic square is an N-by-N matrix '... 
'constructed from the integers 1 through N^2 '... 
'with equal row, column, and diagonal sums.']); 
append(sec1,para);

append(chapter,sec1);
sec2 = Section("Albrect Durer and the Magic Square"); 
para = Paragraph([ ... 
'The German artist Albrecht Durer (1471-1528) created '... 
'many woodcuts and prints with religious and '... 
'scientific symbolism. One of his most famous works, '... 
'Melancholia I, explores the depressed state of mind '... 
'which opposes inspiration and expression. '... 
'Renaissance astrologers believed that the Jupiter '... 
'magic square (shown in the upper right portion of '... 
'the image) could aid in the cure of melancholy. The '... 
'engraving''s date (1514) can be found in the '... 
'lower row of numbers in the square.']); 
append(sec2,para);
 
append(chapter,sec2);

append(rpt,chapter);

close(rpt);
rptview(rpt);

См. также

mlreportgen.dom.PageMargins | mlreportgen.dom.PageSize | mlreportgen.report.Report | mlreportgen.report.Reporter | mlreportgen.report.ReporterLayout | mlreportgen.report.ReportLayout

Связанные темы

• Что такое репортер?
• Настройка размера страницы и полей отчета Word с помощью шаблонов
• Настройка размера страницы и полей PDF-отчета с помощью шаблонов