mlreportgen.dom.PageSize class

Пакет: mlreportgen.dom

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

Описание

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

The 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 - picas

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметры

  • pc - picas

  • pt - точки

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

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

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

The 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 и присвойте его объекту размещения, используемому объектом section reporter. Этот пример задает высоту 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