В отчете Report API можно создать список фигур или таблиц в отчете, чтобы можно было просматривать список и легко переходить к определенному рисунку или таблице. Чтобы создать список фигур, добавьте mlreportgen.report.ListOfFigures репортер доклада. Чтобы создать список таблиц, добавьте mlreportgen.report.ListOfTables репортер доклада.
Примечание
Чтобы создать раздел для списка других элементов отчета, таких как уравнения, используйте mlreportgen.report.ListOfCaptions репортер.
A ListOfFigures или ListOfTables reporter создает местозаполнитель для списка в новом разделе отчета. Как правило, список рисунков или список таблиц добавляется после оглавления и перед разделами, содержащими содержимое отчета. В отчетах PDF и Microsoft ® Word список рисунков или разделов таблиц находится там, где они помещаются в отчет. В HTML-отчетах разделы располагаются на боковой панели.
Способ создания списка фигур или таблиц зависит от вида отчета:
PDF - API отчетов генерирует список во время создания отчета.
Word - необходимо создать список путем обновления документа Word в программе создания отчетов или в интерактивном режиме в Word. См. раздел Обновление оглавления или сгенерированного списка в документе Word.
HTML - HTML-браузер создает список.
Раздел списка рисунков содержит список титров всех изображений, которые представлены как mlreportgen.report.FormalImage или mlreportgen.report.Figure объекты. Раздел списка таблиц содержит список названий всех таблиц, представленных как mlreportgen.report.BaseTable объекты. Каждый элемент списка в списке рисунков или таблиц связан с подписью или заголовком в отчете. В отчетах PDF и Word элемент списка также включает номер страницы подписи или заголовка в отчете. Выноска заполняет пространство между заголовком или заголовком и номером страницы.
Чтобы создать раздел списка фигур в отчете, выполните следующие действия.
Создание отчета API отчетов.
Создать ListofFigures объект. Заголовок по умолчанию для списка разделов рисунков: List of Figures. Чтобы указать другой заголовок, задайте Title имущества ListofFigures объект. Добавить ListofFigures объект для отчета.
Создание глав или разделов для содержимого отчета.
Добавление содержимого отчета к главам или разделам. Создать изображения как FormalImage или Figure объекты. Укажите подписи для изображений или фигур. Для FormalImage объект, установите Caption собственность. Для Figure объект, установите Caption имущества FormalImage объект, указанный SnapShot имущества Figure объект.
Закройте отчет.
Чтобы создать раздел списка таблиц в отчете, выполните следующие действия.
Создание отчета API отчетов.
Создать ListofTables объект. Заголовок по умолчанию для раздела списка таблиц: List of Tables. Чтобы указать другой заголовок, задайте Title имущества ListofTables объект. Добавить ListofTables объект для отчета.
Создание глав или разделов для содержимого отчета.
Добавление содержимого отчета к главам или разделам. Создать таблицы как BaseTable и укажите заголовки с помощью Title свойства объектов.
Закройте отчет.
В этом примере показано, как добавить раздел списка фигур и раздел списка таблиц в отчет 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 репортер. Чтобы настроить стиль заголовка, например семейство шрифтов, цвет или размер, используйте один из следующих подходов.
Укажите заголовок как mlreportgen.dom.Text и задайте стиль с помощью свойств объекта.
Укажите стиль заголовка в шаблоне, используемом ListOfFigures или ListOfTables репортер.
Укажите стиль заголовка в шаблоне, используемом репортером заголовков для списка фигур или заголовков разделов таблиц. См. разделы Использование пользовательского шаблона для заголовка списка фигур и Использование пользовательского шаблона для заголовка списка таблиц.
mlreportgen.report.BaseTable | mlreportgen.report.Figure | mlreportgen.report.FormalImage | mlreportgen.report.ListOfCaptions | mlreportgen.report.ListOfFigures | mlreportgen.report.ListOfTables