mlreportgen.dom.WhiteSpace class

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

Тип белого пространства

Описание

Задает поведение белых пространств и линии пропусков в тексте.

Конструкция

ws = WhiteSpace(option) применяет заданную опцию «пустое пространство» к пустому пространству в Text или Paragraph объект. Для PDF можно задать WhiteSpace только для Paragraph объект.

Входные параметры

расширить все

Поведение белого пространства, заданное в качестве одного из следующих значений.

Примечание

Только 'preserve' и 'normal' влияет на выход Word.

ЗначениеОписание

'preserve'

Сохраняет пространства и пропуски линий.

'normal' (по умолчанию)

Для HTML и PDF удаляет начальные и конечные пространства и сворачивает несколько пространства в тексте в одно пространство, игнорируя пропуски линий.

Для Word удаляет начальные и конечные пространства, игнорируя пропуски линий.

'nowrap'

Последовательности белых пространств коллапсируют в единое белое пространство. Текст не переносится в следующую линию. Текст продолжается в той же линии до <br /> обнаружен тег.

'pre'

Сохраняет пустое пространство. Текст переносится только на пропуски линий. Действует как <pre> тег в HTML.

'pre-line'

Последовательности белых пространств сворачиваются в единое белое пространство. Текст переносится при необходимости и на пропусках линий.

'pre-wrap'

Сохраняет пустое пространство. Текст переносится при необходимости и на пропусках линий.

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

расширить все

Тип пробела, возвращенный как mlreportgen.dom.WhiteSpace объект.

Свойства

расширить все

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

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

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

Как обработать пустое пространство в тексте, заданное как одно из значений в этой таблице.

ЗначениеОписаниеПоддерживаемые выходные типы

'normal'

Для HTML и PDF это значение удаляет пространства в начале и конце текста. Несколько пространства в тексте свернуты в одно пространство.

Для Word это значение удаляет пространства в начале и конце текста.

Все

'nowrap'

Последовательности белого пространства коллапсируют в единое пустое пространство. Текст никогда не переносится в следующую линию.

HTML

'pre'

Сохраняет пустое пространство. Текст переносится только на пропуски линий. Действует как <pre> тег в HTML.

HTML и PDF

'pre-line'

Последовательности белого пространства коллапсируют в единое пустое пространство. Текст переносится при необходимости и на пропусках линий.

HTML и PDF

'pre-wrap'

Сохраняет пустое пространство. Текст переносится при необходимости и на пропусках линий.

HTML и PDF

'preserve'

То же, что и 'pre'.Все

Установка WhiteSpace свойство добавляет соответствующее mlreportgen.dom.WhiteSpace форматировать объект в Style свойство. Установка WhiteSpace свойство для пустого значения удаляет объект.

Примеры

свернуть все

Этот пример показывает эффект использования 'preserve' опция для каждого из выходных форматов. В HTML несколько пространства свернуты, но конечное пространство сохранено. Сохранение конечного пространства полезно, например, при создании заголовка главы. Обычно вы добавляете автонумерацию после текста 'Chapter: '. Использование 'preserve' сохраняет конечное пространство.

import mlreportgen.dom.*;
doctype = 'html';
d = Document('test',doctype);
open(d);
     
p = Paragraph('This paragraph has extra spaces    and one after the colon: ');
p.Style = {WhiteSpace('preserve')};

append(p,'XX');
append(d,p);
     
close(d);
rptview(d.OutputPath);

Этот пример использует выход Word. Несколько пространства не складываются, и конечное пространство сохраняется. Попробуйте прокомментировать WhiteSpace свойство. Несколько пространства сохраняются, но конечное пространство удаляется.

import mlreportgen.dom.*;
doctype = 'docx';
d = Document('test',doctype);
open(d);
     
p = Paragraph('This paragraph has extra spaces    and one after the colon: ');
p.Style = {WhiteSpace('preserve')};

append(p,'XX');
append(d,p);
     
close(d);
rptview(d.OutputPath);

Этот пример использует выход PDF.

import mlreportgen.dom.*;
doctype = 'pdf';
d = Document('test',doctype);
open(d);
     
p = Paragraph('This paragraph has extra spaces    and one after the colon: ');

% p.Style = {WhiteSpace('preserve')};

append(p,'XX');
append(d,p);
     
close(d);
rptview(d.OutputPath);

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