exponenta event banner

Центрирование формального изображения в отчете PDF

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

В этом примере создается отчет PDF API Report, который имеет компоновку ландшафта и использует centerFormalImage локальная функция для добавления формальных изображений в центре страницы.

Создать отчет

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

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

Создание отчета в формате PDF.

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

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

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

pageLayoutObj = PDFPageLayout;

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

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);

Создание и добавление формальных изображений

Создание формальных изображений и вызов centerFormalImage локальная функция для добавления этих формальных изображений в центре страницы.

formalImg1 = FormalImage( ...
    "Image",which("ngc6543a.jpg"), ...
    "Caption","Cat's Eye Nebula or NGC 6543");
centerFormalImage(formalImg1,rpt);

formalImg2 = FormalImage( ...
    "Image",which("peppers.png"), ...
    "Caption","Peppers");
centerFormalImage(formalImg2,rpt);

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

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

close(rpt);
rptview(rpt);

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

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

function centerFormalImage(formalImage,rpt)

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

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

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

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

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

    bodyWidth = units.toInches(pageSize.Width) - ...
        units.toInches(pageMargins.Left) - ...
        units.toInches(pageMargins.Right);
    bodyWidth = sprintf("%0.2fin",bodyWidth);

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

    bodyHeight = units.toInches(pageSize.Height) - ...
        units.toInches(pageMargins.Top) - ...
        units.toInches(pageMargins.Bottom) - ...
        units.toInches(pageMargins.Header) - ...
        units.toInches(pageMargins.Footer);
    bodyHeight = sprintf("%0.2fin",bodyHeight);

Используйте getImageReporter способ FormalImage репортер, чтобы получить репортер изображения и getCaptionReporter способ получения репортера подписи.

    imageReporter = getImageReporter(formalImage,rpt);
    captionReporter = getCaptionReporter(formalImage);

Используйте getImpl методы изображения и caption репортеры для получения соответствующих реализаций DOM.

    imageImpl = getImpl(imageReporter,rpt);
    captionImpl = getImpl(captionReporter,rpt);

Реализации DOM содержат DOM Paragraph который содержит содержимое изображения и подписи. Обновите стиль абзацев, чтобы убедиться в отсутствии пробелов вокруг абзацев и их центрировании в записи таблицы, созданной на следующем шаге.

    paraStyle = { ...
        OuterMargin("0in","0in","0in","0in"), ...
        HAlign("center") ...
        };
    
    imagePara = clone(imageImpl.Children(1));
    imagePara.Style = [imagePara.Style, paraStyle];
    
    captionPara = clone(captionImpl.Children(1));
    captionPara.Style = [captionPara.Style, paraStyle];

Создание невидимой таблицы макетов «1 за 1» (lo_table). Таблица считается невидимой, если границы не определены для таблицы и ее записей.

    lo_table = Table(1);
    row = append(lo_table,TableRow);
    entry = append(row,TableEntry);

Добавьте абзацы, содержащие содержимое изображения и подписи, к единственной записи таблицы в невидимой таблице макетов.

    append(entry,imagePara);
    append(entry,captionPara);

Распределите таблицу по доступной ширине тела страницы.

    lo_table.Width = bodyWidth;

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

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

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

    add(rpt,lo_table);
end

См. также

| | | | |

Связанные темы