Формальная таблица DOM API имеет разделы заголовка, тела и нижнего колонтитула. Формальная таблица полезна, когда верхний или нижний колонтитул имеет несколько строк. Отдельные разделы заголовка, тела и нижнего колонтитула облегчают добавление строк в и форматирование заголовка, тела или нижнего колонтитула независимо от других разделов. Дополнительные сведения о других типах таблиц, которые можно создать в отчетах, см. в разделе Выбор типа таблицы для создания. Дополнительные сведения о форматировании таблиц см. в разделе «Формат таблиц».
Формальная таблица представлена mlreportgen.dom.FormalTable объект. Разделы заголовка, тела и нижнего колонтитула представлены mlreportgen.dom.TableHeader, mlreportgen.dom.TableBody, и mlreportgen.dom.TableFooter объекты, соответственно. В каждом разделе содержатся строки и записи таблицы. Строки представлены mlreportgen.dom.TableRow объекты. Записи в разделах тела и нижнего колонтитула представлены mlreportgen.dom.TableEntry объекты. Записи в заголовке представлены mlreportgen.dom.TableHeaderEntry или mlreportgen.dom.TableEntry объекты.
Можно создать разделы формальной таблицы из MATLAB® массив. Этот подход является самым простым, потому что вы не должны создавать TableRow и TableEntry или TableHeaderEntry объекты. Можно также создать разделы, создав таблицу из TableRow и TableEntry или TableHeaderEntry объекты. Этот подход полезен для сложных требований форматирования, таких как, когда запись охватывает несколько столбцов или строк. Можно объединить подходы. Например, можно создать тело таблицы из массива и создать заголовок из строк и записей.
Составьте формальную таблицу при помощи mlreportgen.dom.FormalTable конструктор. Конструктор опционально принимает двумерный массив или массив ячеек данных MATLAB для тела, заголовка и нижнего колонтитула. Смотрите header, body, и footer аргументы на mlreportgen.dom.FormalTable страница с описанием. Для примера, который создает заголовок формальной таблицы из строковых массивов и тело формальной таблицы из массива ячеек, см. Раздел «Создание таблицы из массива ячеек».
Можно создать разделы заголовка, тела или нижнего колонтитула формальной таблицы, добавив записи таблицы к строкам таблицы и добавив строки к разделам.
Для создания записи заголовка можно использовать mlreportgen.dom.TableHeaderEntry или mlreportgen.dom.TableEntry объект. Если вы создаете заголовок из массива, DOM API создает записи следующим образом TableHeaderEntry объекты. В отчете HTML DOM API отображает TableHeaderEntry объект как th(ячейка заголовка таблицы) элемента. Этот рендеринг полагается на браузер для форматирования записи таблицы. Для отчетов Word и PDF по умолчанию DOM API отображает TableHeaderEntry объект как неформатированный элемент Word или PDF таблицы entry. Можно использовать TableHeaderEntry свойства объекта для форматирования записей таблицы, сгенерированных для всех выходных типов. Для примера можно использовать эти свойства для переопределения форматирования браузера в отчетах HTML.
Чтобы создать раздел формальной таблицы из строк и записей таблицы, можно использовать FormalTable
appendHeaderRow, append, и appendFooterRow методы для добавления строк к разделам заголовка, тела или нижнего колонтитула таблицы. Кроме того, вы можете получить доступ к разделу при помощи Header, Body, или Footer свойства FormalTable объект, а затем добавить строки к разделу с помощью append способ.
Пример, в котором заголовок создается из записей и строк, см. в Формальная таблица в разделе Пролет записи таблицы по строкам и столбцам.
appendFooterRow | appendHeaderRow | mlreportgen.dom.FormalTable | mlreportgen.dom.TableBody | mlreportgen.dom.TableEntry | mlreportgen.dom.TableFooter | mlreportgen.dom.TableHeader | mlreportgen.dom.TableHeaderEntry