mlreportgen.dom. Класс WhiteSpace

Пакет: 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.

Свойства

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

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

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

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

Например, чтобы облегчить идентифицировать, где проблема произошла во время генерации документов, можно задать собственное значение тега.

Чтобы задать, как обработать пробел, используйте одно из этих значений.

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

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

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

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

Все выходные типы

'nowrap'

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

HTML

'preserve'

Пробелы консервов и переводы строки. Законы как <pre> помечают в HTML.

Все выходные типы

'pre'

Пробел консервов. Текст переносится только на разрывах строки. Законы как <pre> помечают в HTML.

HTML и PDF

'pre-line'

Последовательности пробела выходят из строя в один пробел. Текст переносится.

HTML и PDF

'pre-wrap'

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

HTML и PDF

Установка свойства WhiteSpace добавляет соответствующий объект формата WhiteSpace в свойство Style. Удаление установки свойства WhiteSpace удаляет объект 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);