exponenta event banner

Создание списка рисунков или таблиц в отчете API отчета

В отчете Report API можно создать список фигур или таблиц в отчете, чтобы можно было просматривать список и легко переходить к определенному рисунку или таблице. Чтобы создать список фигур, добавьте mlreportgen.report.ListOfFigures репортер доклада. Чтобы создать список таблиц, добавьте mlreportgen.report.ListOfTables репортер доклада.

Примечание

Чтобы создать раздел для списка других элементов отчета, таких как уравнения, используйте mlreportgen.report.ListOfCaptions репортер.

A ListOfFigures или ListOfTables reporter создает местозаполнитель для списка в новом разделе отчета. Как правило, список рисунков или список таблиц добавляется после оглавления и перед разделами, содержащими содержимое отчета. В отчетах PDF и Microsoft ® Word список рисунков или разделов таблиц находится там, где они помещаются в отчет. В HTML-отчетах разделы располагаются на боковой панели.

Способ создания списка фигур или таблиц зависит от вида отчета:

Раздел списка рисунков содержит список титров всех изображений, которые представлены как mlreportgen.report.FormalImage или mlreportgen.report.Figure объекты. Раздел списка таблиц содержит список названий всех таблиц, представленных как mlreportgen.report.BaseTable объекты. Каждый элемент списка в списке рисунков или таблиц связан с подписью или заголовком в отчете. В отчетах PDF и Word элемент списка также включает номер страницы подписи или заголовка в отчете. Выноска заполняет пространство между заголовком или заголовком и номером страницы.

Создание списка сечений рисунков

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

  1. Создание отчета API отчетов.

  2. Создать ListofFigures объект. Заголовок по умолчанию для списка разделов рисунков: List of Figures. Чтобы указать другой заголовок, задайте Title имущества ListofFigures объект. Добавить ListofFigures объект для отчета.

  3. Создание глав или разделов для содержимого отчета.

  4. Добавление содержимого отчета к главам или разделам. Создать изображения как FormalImage или Figure объекты. Укажите подписи для изображений или фигур. Для FormalImage объект, установите Caption собственность. Для Figure объект, установите Caption имущества FormalImage объект, указанный SnapShot имущества Figure объект.

  5. Закройте отчет.

Создание раздела списка таблиц

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

  1. Создание отчета API отчетов.

  2. Создать ListofTables объект. Заголовок по умолчанию для раздела списка таблиц: List of Tables. Чтобы указать другой заголовок, задайте Title имущества ListofTables объект. Добавить ListofTables объект для отчета.

  3. Создание глав или разделов для содержимого отчета.

  4. Добавление содержимого отчета к главам или разделам. Создать таблицы как BaseTable и укажите заголовки с помощью Title свойства объектов.

  5. Закройте отчет.

Создание отчета со списком рисунков и списком таблиц

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

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

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

Создание отчета API отчетов. Добавьте в отчет титульную страницу и оглавление.

rpt = Report('magic','docx'); 
tp = TitlePage; 
tp.Title = 'Magic Squares'; 
tp.Author = 'John Doe'; 
append(rpt,tp); 
append(rpt,TableOfContents); 

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

lof = ListOfFigures();
append(rpt,lof);
lot = ListOfTables();
append(rpt,lot);

Создайте содержимое отчета. Для этого примера создайте главу для введения в магические квадраты и главу для примера магического квадрата.

ch1 = Chapter('Introduction'); 
sec1 = Section('What is a Magic Square?'); 
para = Paragraph(['A magic square is an N-by-N matrix '... 
'constructed from the integers 1 through N^2 '... 
'with equal row, column, and diagonal sums.']); 
append(sec1,para); 
append(ch1,sec1); 

sec2 = Section('Albrecht Durer and the Magic Square'); 
para = Paragraph(['A 4-by-4 magic square appears in the upper right corner ' ... 
    'of the engraving, Melancholia I, by German artist Albrecht Durer (1471-1528).']);
append(sec2,para); 
append(ch1,sec2) ;

Добавить изображение durer.png к главе в качестве mlreportgen.report.FormalImage объект, чтобы изображение было включено в список фигур.

im = FormalImage('durer.png');
im.Caption = 'Melancholia I by Albrecht Durer';
append(sec2,im);
append(rpt,ch1);

Создайте вторую главу.

ch2 = Chapter('Magic Square Example'); 
square = magic(10); 

Создание таблицы на основе выходных данных magic(10) и добавить его в главу. Представление таблицы в виде mlreportgen.report.BaseTable чтобы таблица была включена в список таблиц.

tbl = BaseTable(square); 
tbl.Title = 'Order Ten Magic Square';
append(ch2,tbl); 

Создайте цветное изображение магического квадрата и добавьте его в главу в виде mlreportgen.report.Figure объект, чтобы изображение было включено в список фигур.

clf; 
imagesc(square) 
axis equal 
axis off
fig = Figure(gcf); 
fig.Snapshot.Caption = 'Color-coded image of 10-by-10 magic square'; 
append(ch2,fig); 
append(rpt,ch2); 

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

close(rpt);
rptview(rpt);

Вот список цифр в отчете:

Вот список таблиц в отчете:

Настройка списка рисунков или разделов таблиц

Можно указать название раздела списка фигур или списка таблиц, задав Title имущества ListOfFigures или ListOfTables репортер. Чтобы настроить стиль заголовка, например семейство шрифтов, цвет или размер, используйте один из следующих подходов.

См. также

| | | | |

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