mlreportgen.dom. Класс PageMargins

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

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

Уникальный идентификатор сеанса сгенерирован как часть создания элемента документа. Сгенерированный тег имеет форму CLASS:ID, где CLASS является классом элемента, и 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