exponenta event banner

mlreportgen.dom.Класс контейнера

Пакет: mlreportgen.dom
Суперклассы:

Контейнер объектов документа

Описание

Создание элемента контейнера. Используйте mlreportgen.dom.Container.append для добавления элементов документа к контейнеру. Использовать mlreportgen.dom.Container объект в отчете для применения форматов ко всем нижестоящим элементам контейнера.

В выходных данных HTML Container объект генерирует HTML-элемент типа, заданного его HTMLTag и содержащий элементы HTML, соответствующие его содержимому DOM. Например, Container объект с HTMLTag собственность div и который содержит текст Hello World генерирует эту разметку:

<div><p><span>Hello World</span></p></div>

Созданный элемент контейнера HTML имеет свойства класса и стиля, указанные Container объект StyleName и Style соответственно. Правила наследования формата HTML CSS гарантируют, что сгенерированные нижестоящие элементы Container объект наследует форматы, указанные Container объект Style и StyleName свойства. Например, если Container объект задает красный цвет в качестве цвета текста, и ни один из его потомков текста не указывает цвет, потомки текста окрашиваются в красный цвет.

Для вывода отчетов Microsoft ® Word и PDF Container объект моделирует наследование формата контейнера, применяя форматы, указанные Container объект Style атрибут для каждого нижестоящего элемента, если он не переопределен нижестоящим элементом, а затем добавляется к выходному элементу. Выходные данные Word и PDF игнорируют HTMLTag и StyleName свойства Container объект.

Совет

Вы можете использовать mlreportgen.dom.Container или mlreportgen.dom.Group объекты для создания коллекций элементов документа.

  • Объект-контейнер используется для применения наследования формата к набору объектов и создания элементов контейнера HTML, не поддерживаемых DOM, таких как div, section и article.

  • Используйте объект группы для добавления одного и того же содержимого в нескольких местах документа без клонирования группы.

Строительство

containerObj = Container() создает контейнер с именем тега HTML div.

пример

containerObj = Container(HTMLtag) создает контейнер с указанным именем тега HTML (например, div, section, или article).

Входные аргументы

развернуть все

Имя тега контейнера HTML, указанное как символьный вектор. Имя должно быть HTML-элементом, например 'div', 'section', или 'article'.

Примечание

Выходные данные Word игнорируют тег контейнера HTML.

Выходные аргументы

развернуть все

Контейнер объектов документа, возвращаемый как mlreportgen.dom.Container объект.

Свойства

развернуть все

Идентификатор для этого элемента документа, указанный как вектор символов или скаляр строки. При создании элемента документа DOM создает уникальный идентификатор сеанса. Можно указать собственный идентификатор.

Это свойство только для чтения содержит список дочерних элементов, содержащихся в контейнере.

Имя тега контейнера HTML, указанное как символьный вектор. Имя должно быть HTML-элементом, например 'div', 'section', или 'article'.

Примечание

Выходные данные Word игнорируют тег контейнера HTML.

Родительский элемент этого документа, указанный как объект DOM. Это свойство доступно только для чтения.

Спецификация формата, заданная как массив объектов формата. Форматы, указанные этим свойством, переопределяют соответствующие форматы, определенные стилем таблицы стилей, указанным StyleName свойство этого элемента. Форматы, которые не применяются к этому элементу, игнорируются.

Имя стиля, указанное как символьный вектор. Имя стиля - это имя стиля, указанного в таблице стилей документа или детали документа, к которой присоединен этот элемент. Указанный стиль определяет внешний вид этого элемента в документе вывода, где он не переопределяется форматами, указанными в Style свойство этого элемента.

Примечание

Выходные данные Word игнорируют имя стиля.

Тег для этого элемента документа, заданный как вектор символов или скаляр строки.

DOM создает уникальный для сеанса тег как часть создания этого объекта. Созданный тег имеет вид CLASS: ID, где CLASS - класс объекта, а ID - значение Id свойства объекта. Указание собственного значения тега может помочь определить, где возникла проблема во время создания документа.

Методы

приложитьДобавить объект DOM к контейнеру
клонКопировать объект-контейнер

Примеры

свернуть все

Создайте объект-контейнер. Вывод Word игнорирует тег элемента контейнера HTML (в этом примере div тег).

import mlreportgen.dom.*;
rpt = Document('MyReport','docx');

c = Container();

Цвет всего текста контейнера - красный.

c.Style = {Color('red')};

Добавьте содержимое в контейнер и добавьте контейнер в отчет.

append(c,Paragraph('Hello'));
append(c,Table(magic(5)));
append(rpt,c);

Закройте и создайте отчет.

close(rpt);
rptview(rpt.OutputPath);
Представлен в R2015a