Центрирование снимка фигуры на странице

В этом примере показано, как центрировать снимок рисунка на странице ландшафта для отчетов PDF и Microsoft ® Word.

Пример создает отчет Report API с ландшафтным размещением, создает фигуры MATLAB, а затем использует centerFigure локальная функция для создания и добавления моментальных снимков этих рисунков в центре страницы.

Создание отчета

Импортируйте пакеты DOM и Report API так, чтобы не использовать длинные, полные имена классов.

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

Создание отчета PDF. Чтобы создать отчет Microsoft ® Word, измените "pdf"на "docx".

rpt = Report("myreport","pdf");
open(rpt);

Обновление макета страницы отчета

Создайте объект макета страницы.

if strcmpi(rpt.Type,"pdf")
    pageLayoutObj = PDFPageLayout;
else
    pageLayoutObj = DOCXPageLayout;
end

Укажите ориентацию, высоту и ширину страницы.

pageLayoutObj.PageSize.Orientation = "landscape";
pageLayoutObj.PageSize.Height = "8.5in";
pageLayoutObj.PageSize.Width = "11in";

Укажите поля страницы.

pageLayoutObj.PageMargins.Top = "0.5in";
pageLayoutObj.PageMargins.Bottom = "0.5in";
pageLayoutObj.PageMargins.Left = "0.5in";
pageLayoutObj.PageMargins.Right = "0.5in";

pageLayoutObj.PageMargins.Header = "0.3in";
pageLayoutObj.PageMargins.Footer = "0.3in";

Добавьте объект макета страницы в отчет.

add(rpt,pageLayoutObj);

Создание и добавление фигур

Создать рисунок с линейным графиком.

f = figure();
plot(1:1:10,2:2:20);
grid on;

Вызовите centerFigure локальная функция для добавления рисунка снимка в центр страницы. Затем удалите объект рисунка.

centerFigure(f,rpt);

delete(f);

Точно так же добавьте снимок мембраны объемной поверхностной диаграммы в центр страницы.

centerFigure(surf(membrane),rpt);

delete(gcf);

Сгенерируйте отчет

Закройте и просмотрите отчет.

close(rpt);
rptview(rpt);

The centerFigure Локальная функция

Эта функция создает снимок указанного рисунка и добавляет ее в центр страницы в указанном отчете. Функция использует Report API Figure reporter, чтобы сделать снимок рисунка и невидимый DOM Table для выполнения размещения.

function centerFigure(figure,rpt)

Импортируйте пакеты DOM API, Report API и утилиты генератора отчетов, чтобы не использовать длинные, полные имена классов.

    import mlreportgen.dom.*
    import mlreportgen.report.*
    import mlreportgen.utils.*

Получите текущий макет страницы отчета, чтобы определить текущий размер страницы и поля страницы. Информация о макете страницы используется для вычисления размера тела страницы в порядок размера таблицы размещения, созданной на следующем шаге.

    pageLayout = getReportLayout(rpt);
    pageSize = pageLayout.PageSize;
    pageMargins = pageLayout.PageMargins;

Вычислите ширину тела страницы. Ширина тела страницы обозначает ширину страницы, доступную для содержимого, и определяется путем вычитания размера левого и правого полей из ширины страницы. Для выхода DOCX также необходимо вычесть размер желоба.

    bodyWidth = units.toInches(pageSize.Width) - ...
        units.toInches(pageMargins.Left) - ...
        units.toInches(pageMargins.Right);
    
    if strcmpi(rpt.Type,"docx")
        bodyWidth = bodyWidth - ...
            units.toInches(pageMargins.Gutter);
    end
    bodyWidth = sprintf("%0.2fin",bodyWidth);

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

    bodyHeight = units.toInches(pageSize.Height) - ...
        units.toInches(pageMargins.Top) - ...
        units.toInches(pageMargins.Bottom);
    
    if strcmpi(rpt.Type,"pdf")
        bodyHeight = bodyHeight - ...
            units.toInches(pageMargins.Header) - ...
            units.toInches(pageMargins.Footer);
    end
    bodyHeight = sprintf("%0.2fin",bodyHeight);

Создайте Figure объект для заданного рисунка. Затем создайте Image объект, обернутый вокруг файла изображения моментального снимка рисунка. Масштабирование изображения в соответствии с записью размещения, созданной на следующем шаге.

    fig = Figure(figure);
    figImg = Image(getSnapshotImage(fig,rpt));
    figImg.Style = [figImg.Style {ScaleToFit}];

Поместите изображение в абзац, так как PDF требует, чтобы изображение находилось в абзаце. Обновите стиль абзаца, чтобы убедиться, что вокруг изображения нет свободного пространства.

    para = Paragraph(figImg);
    para.Style = [para.Style {OuterMargin("0in","0in","0in","0in")}];

Добавьте абзац, который содержит снимок рисунка в невидимое размещение 1 на 1 (lo_table). Таблица считается невидимой, если границы не определены для таблицы и ее записей.

    lo_table = Table({para});

Отобразить таблицу на доступную ширину тела страницы.

    lo_table.Width = bodyWidth;

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

    lo_table.TableEntriesStyle = [lo_table.TableEntriesStyle ...
        { ...
        Height(bodyHeight), ...
        HAlign("center"), ...
        VAlign("middle") ...
        }];

Добавьте форматированную таблицу к отчету.

    add(rpt,lo_table);
end

См. также

| | | | | |

Похожие темы

Для просмотра документации необходимо авторизоваться на сайте