exponenta event banner

класс mlreportgen.dom.PageSize

Пакет: mlreportgen.dom

Размер и ориентация страниц в отчетах Microsoft Word и PDF

Описание

Использование объекта mlreportgen.dom.PageSize для указания высоты, ширины и ориентации страниц в отчете Microsoft ® Word или PDF.

mlreportgen.dom.PageSize класс является handle класс.

Атрибуты класса

ConstructOnLoad
true
HandleCompatible
true

Сведения об атрибутах класса см. в разделе Атрибуты класса.

Создание

Описание

PageSizeObj = mlreportgen.dom.PageSize() создает PageSize со свойствами, задающими высоту 11 дюймов, ширину 8,5 дюйма и портретную ориентацию.

PageSizeObj = mlreportgen.dom.PageSize(height,width) создает объект размера страницы с заданными высотой и шириной и портретной ориентацией.

пример

PageSizeObj = mlreportgen.dom.PageSize(height,width,orientation) создает объект размера страницы с заданными высотой, шириной и ориентацией.

Свойства

развернуть все

Высота страниц, заданная как вектор символов или строковый скаляр, состоящий из числа, за которым следует сокращение единицы измерения. Например, '11in' задает 11 дюймов. Допустимые сокращения:

  • px - пикселы (по умолчанию)

  • cm - сантиметров

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

Ширина страниц, заданная как вектор символов или строковый скаляр, состоящий из числа, за которым следует сокращение единицы измерения. Например, '8.5in' задает 8,5 дюйма. Допустимые сокращения:

  • px - пикселы (по умолчанию)

  • cm - сантиметров

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

Ориентация страниц, заданная как один из следующих векторов символов или строковых скаляров:

  • 'portrait' для вертикальной ориентации

  • 'landscape' для горизонтальной ориентации

Height и Width свойства определяют ориентацию страницы, независимо от значения Orientation собственность. Тем не менее, это лучшая практика, чтобы установить Orientation к значению, совместимому с размерами страницы. Если высота больше ширины, установите значение Orientation кому 'portrait'. Если ширина больше высоты, установите значение Orientation кому 'landscape'.

Тег для этого элемента документа, заданный как вектор символов или скаляр строки.

DOM создает уникальный для сеанса тег как часть создания этого объекта. Созданный тег имеет вид CLASS: ID, где CLASS - класс объекта, а ID - значение Id свойства объекта. Указание собственного значения тега может помочь определить, где возникла проблема во время создания документа.

Идентификатор для этого элемента документа, указанный как вектор символов или скаляр строки. При создании элемента документа DOM создает уникальный идентификатор сеанса. Можно указать собственный идентификатор.

Примеры

свернуть все

Использовать PageSize для указания размера страницы документа. В PageSize объект, установите Orientation к значению, совместимому со значением Height и Width свойства.

По умолчанию документ имеет страницы с 11-дюймовой высотой, 8,5-дюймовой шириной и портретной ориентацией. Можно переопределить размер страницы по умолчанию, задав значение Height и Width свойства PageSize используется объектом макета документа. Например, укажите, что Height является "10in", Width является "8in", и Orientation является "portrait".

import mlreportgen.dom.*;
d = Document("myreport1","docx");
open(d);
 
pageLayoutObj = d.CurrentPageLayout;
pageLayoutObj.PageSize.Height = "10in";
pageLayoutObj.PageSize.Width = "8in";
pageLayoutObj.PageSize.Orientation  = "portrait";
append(d,"This document has portrait pages");

close(d);
rptview(d);

Задание высоты меньше ширины делает ориентацию ландшафтом независимо от значения Orientation собственность. В этом примере задается высота 8 дюймов и ширина 10 дюймов. Пример устанавливает Orientation свойство для "landscape" для соответствия размеру страницы.

import mlreportgen.dom.*;
d = Document("myreport2","docx");
open(d);
 
pageLayoutObj = d.CurrentPageLayout;
pageLayoutObj.PageSize.Height = "8in";
pageLayoutObj.PageSize.Width = "10in";
pageLayoutObj.PageSize.Orientation  = "landscape";
append(d,"This document has landscape pages");

close(d);
rptview(d);

Вместо изменения ориентации страницы путем изменения высоты и ширины можно использовать rotate метод объекта макета. Метод переключает Height и Width значения свойств и изменение Orientation свойство из portrait кому landscape или landscape кому portrait.

import mlreportgen.dom.*;
d = Document("myreport3","docx");
open(d);
 
pageLayoutObj = d.CurrentPageLayout;
pageLayoutObj.PageSize.Height = "10in";
pageLayoutObj.PageSize.Width = "8in";
pageLayoutObj.PageSize.Orientation  = "portrait";
rotate(pageLayoutObj);
append(d,"This document has landscape pages");

close(d);
rptview(d);

Использовать PageSize для указания размера страницы отчета или раздела отчета. В PageSize объект, установите Orientation к значению, совместимому со значением Height и Width свойства.

По умолчанию отчет содержит страницы высотой 11 дюймов и шириной 8,5 дюйма. Чтобы переопределить размер страницы по умолчанию для отчета, создайте PageSize и присвойте его объекту формата отчета. Чтобы переопределить размер страницы для раздела отчета, создайте PageSize и назначить его объекту макета, используемому объектом-репортером раздела. В этом примере указывается 10-дюймовая высота и 8-дюймовая ширина отчета. Титульная страница переопределяет размер страницы отчета, а остальная часть отчета использует размер страницы отчета.

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

rpt = Report("myreport1","docx");
open(rpt);

layoutObj = rpt.Layout;
layoutObj.PageSize = PageSize("10in","8in","portrait");

tp = TitlePage("Title","Title Page");
tplayoutObj = tp.Layout;
tplayoutObj.PageSize = PageSize("11in","9in","portrait");
append(rpt,tp);

toc = TableOfContents;
append(rpt,toc);

ch = Chapter("My Chapter");
para = Paragraph("This chapter uses the report page size");

close(rpt);
rptview(rpt);

Размер страницы отчета по умолчанию имеет портретную ориентацию. Чтобы изменить ориентацию всех страниц отчета, используйте Landscape свойства объекта макета отчета. В этом примере указывается альбомная ориентация для всех страниц отчета.

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

rpt = Report("myreport2","docx");
open(rpt);

layoutObj = rpt.Layout;
layoutObj.Landscape = true;

tp = TitlePage("Title","Title Page","SubTitle","With Page Size and Orientation of Report");
append(rpt,tp);

close(rpt);
rptview(rpt);

Чтобы изменить ориентацию страниц в разделе относительно ориентации страниц отчета, используйте Landscape свойства объекта компоновки сечения. В этом примере отчет имеет размеры по умолчанию, 11-дюймовую высоту и 8,5-дюймовую ширину, т.е. портретную ориентацию. В примере изменяется ориентация титульной страницы на альбомную.

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

rpt = Report("myreport3","docx");
open(rpt);
tp = TitlePage("Title","Title Page","SubTitle","With Landscape Orientation");
tplayoutObj = tp.Layout;
tplayoutObj.Landscape = true;
append(rpt,tp);

close(rpt);
rptview(rpt);
Представлен в R2016a