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

'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);