mlreportgen.dom.PageMargins class

Пакет: mlreportgen.dom

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

Описание

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

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

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

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

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

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

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

HandleCompatible
true
ConstructOnLoad
true

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

Создание

Описание

пример

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

Свойства

расширить все

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

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

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

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