mlreportgen.dom.PageSize class

Пакет: 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 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

Ориентация страниц в виде одного из этих векторов символов или строковых скаляров:

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

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

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

Пометьте для этого элемента документа в виде вектора символов или строкового скаляра.

DOM генерирует уникальный для сеанса тег как часть создания этого объекта. Сгенерированный тег имеет форму CLASS:ID, где КЛАСС является классом объекта, и ID является значением Id свойство объекта. Определение вашего собственного значения тега может помочь вам идентифицировать, где проблема произошла во время генерации документов.

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

Примеры

свернуть все

Используйте 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
Для просмотра документации необходимо авторизоваться на сайте