mlreportgen.dom.PageMargins class

Пакет: mlreportgen.dom

Поля страницы для Microsoft Word и макета страницы PDF

Описание

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

Создание верхних колонтитулов страницы и нижних колонтитулов отличается между Word и документами в формате PDF. Например, верхние колонтитулы страницы PDF и нижние колонтитулы фиксируются в размере. Заголовки Word и нижние колонтитулы расширяются, чтобы соответствовать содержимому. Поэтому внешний вид верхних и нижних полей страницы с помощью тех же значений может отличаться на основе выходного типа.

Кроме того, верхние и нижние поля обработаны по-другому для различных выходных типов. Эти различия могут привести к различным разрывам страницы даже с теми же установками поля.

  • Для PDF общая высота верхнего поля равняется значению Top свойство этого объекта плюс высота Header свойство. Основной текст запускается ниже заголовка. Для документов Word верхнее поле и заголовок расширяются, чтобы предотвратить наложение заголовка и основного текста.

  • Точно так же общая высота нижнего поля PDF равняется значению Bottom свойство этого объекта плюс высота Footer свойство. Основной текст заканчивается выше нижнего колонтитула. Для документов Word нижний колонтитул расширяется, чтобы предотвратить наложение основного текста.

mlreportgen.dom.PageMargins классом является handle класс.

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

HandleCompatible
true
ConstructOnLoad
true

Для получения информации об атрибутах класса см. Атрибуты класса.

Создание

Описание

пример

pageMarginsObj = mlreportgen.dom.PageMargins() создает PageMargins объект со свойствами, которые задают 1-дюймовую верхнюю часть, нижнюю часть, оставленную, и правые поля, 0,5-дюймовый заголовок и нижний колонтитул и поле на 0 пикселей.

Свойства

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

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

Размер поля в виде вектора символов или строкового скаляра, который состоит из номера, сопровождаемого сокращением от единицы измерения. Например, '0px' задает 0 пикселей. Допустимые сокращения:

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

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

Примеры

свернуть все

В PageMargins объект, сопоставленный с объектом макета документа, задайте 0,5-дюймовые поля.

import mlreportgen.dom.*;
d = Document('myreport','docx');
open(d);
 
pageLayoutObj = d.CurrentPageLayout;
pageLayoutObj.PageMargins.Left  = '0.5in';
pageLayoutObj.PageMargins.Right = '0.5in';
append(d,'Left and right margins are 0.5 inches.');

close(d);
rptview(d);

Используйте mlreportgen.dom.PageMargins объект задать 0,5-дюймовые поля. Присвойте объект PageMargins свойство объекта размещения отчета.

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

rpt = Report('myreport','docx');
open(rpt);
 
pageMarginsObj = PageMargins();
pageMarginsObj.Left = '0.5in';
pageMarginsObj.Right = '0.5in';
rpt.Layout.PageMargins = pageMarginsObj;

append(rpt,'Left and right margins are 0.5 inches.');
close(rpt);
rptview(rpt);
Введенный в R2016a