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 объект.

Свойства

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

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

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

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'

То же самое как 'пред'.Все

Установка 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);