Exponenta Banner
exponenta event banner

mlreportgen.dom.PageMargins класс

Пакет: mlreportgen.dom

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

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

Описание

Использование объекта mlreportgen.dom.PageMargins для указания размера полей страницы раздела отчета Microsoft ® Word или 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 - сантиметров

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • 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

Документация по генератору отчетов MATLAB

Поддержка