mlreportgen.dom.PageMargins class

Пакет: mlreportgen.dom
Суперклассы:

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

Описание

Задает размер полей страницы раздела Word Microsoft® или документа в формате PDF.

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

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

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

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

Конструкция

PageMarginsObj = PageMargins() задает поля страницы по умолчанию, которые составляют один дюйм для верхней части, нижней части, оставленной, и правые поля, половина дюйма для заголовка и нижнего колонтитула, и обнуляют пиксели для поля.

Выходные аргументы

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

Поля страницы, возвращенные как mlreportgen.dom.PageMargins объект.

Свойства

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

Ширина нижнего поля, заданного в форме valueUnits, где Units сокращение от модулей. Допустимые сокращения:

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

Размер поля, заданный в форме valueUnits, где Units сокращение от модулей, чтобы использовать. Допустимые сокращения:

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

Размер заголовка, заданный в форме valueUnits, где Units сокращение от модулей. Допустимые сокращения:

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

Размер левого поля, заданный в форме valueUnits, где Units сокращение от модулей. Допустимые сокращения:

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

Размер правого поля, заданный в форме valueUnits, где Units сокращение от модулей. Допустимые сокращения:

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

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

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

Размер верхнего поля, заданный в форме valueUnits, где Units сокращение от модулей. Допустимые сокращения:

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

  • cm 'centimeters'

  • in 'inches'

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

  • pc — цицеро

  • pt 'points'

Примеры

свернуть все

Установите левые и правые поля для текущего макета страницы к.5 дюймам.

import mlreportgen.dom.*;
d = Document('myreport','docx');
open(d);

s = d.CurrentPageLayout;
s.PageMargins.Left  = '.5in';
s.PageMargins.Right = '.5in';
append(d,'Left and right margins are .5 inch');

close(d);
rptview(d.OutputPath);
Введенный в R2016a
Для просмотра документации необходимо авторизоваться на сайте