Exponenta Banner
exponenta event banner

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

Свойства

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

Идентификатор для этого элемента документа, указанный как вектор символов или скаляр строки. При создании элемента документа 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);

См. также

|

Темы

Документация по генератору отчетов MATLAB

Поддержка