Центрирование изображения на странице

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

Пример создает отчет Report API с ландшафтным размещением и использует centerImage локальная функция для добавления изображений в центр страницы.

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

Импортируйте пакеты 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);

Добавление изображений

Вызовите centerImage локальная функция для добавления изображений в центр страницы.

centerImage(which("ngc6543a.jpg"),rpt);

centerImage(which("peppers.png"),rpt);

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

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

close(rpt);
rptview(rpt);

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

Эта функция добавляет указанное изображение в центр страницы в указанном отчете. Функция использует DOM Image перенос файла изображения и невидимой DOM Table для выполнения размещения.

function centerImage(imageFile,rpt)

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

    import mlreportgen.dom.*
    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);

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

    image = Image(imageFile);
    image.Style = [image.Style {ScaleToFit}];

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

    para = Paragraph(image);
    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

См. также

| | | | | |

Похожие темы