mlreportgen.ppt.TableEntry class

Пакет: mlreportgen.ppt

Описание

Используйте объект mlreportgen.ppt.TableEntry Класс для создания записи таблицы, чтобы добавить ее в строку таблицы в презентации PPT API.

Чтобы добавить содержимое к записи таблицы, добавьте вектор символов или один или несколько mlreportgen.ppt.Paragraph объекты к TableEntry объект.

The mlreportgen.ppt.TableEntry класс является handle класс.

Атрибуты класса

HandleCompatible
true
ConstructOnLoad
true

Для получения информации об атрибутах класса см. раздел «Атрибуты класса».

Создание

Описание

пример

tableEntryObj = mlreportgen.ppt.TableEntry() создает пустой TableEntry объект.

Свойства

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

Семейство шрифтов для текста в этой записи таблицы, заданное в виде вектора символов или строкового скаляра. Укажите шрифт, который отображается в списке шрифтов в Microsoft® PowerPoint®. Чтобы увидеть список шрифтов, в PowerPoint, на вкладке Home, в группе Font, щелкните стреле справа от шрифта.

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

Цвет шрифта для текста в этой записи таблицы, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS или шестнадцатеричного значения RGB.

  • Список названий цвета CSS см. в разделе https://www.crockford.com/wrrrld/color.html.

  • Чтобы задать шестнадцатеричный формат RGB, используйте # в качестве первого символа и двухзначных шестнадцатеричных чисел для красных, зеленых и синих значений. Для примера, '#0000ff' задает синий цвет.

Размер шрифта текста в этой записи таблицы, заданный как вектор символов или строковый скаляр, который состоит из числа, за которым следует единица измерения. Для примера, '11pt' задает 11 точек. Допустимые сокращения:

  • px - пиксели (по умолчанию)

  • cm - сантиметров

  • in - дюймы

  • mm - миллиметры

  • pc - picas

  • pt - точки

Цвет фона записи таблицы, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS или шестнадцатеричного значения RGB.

  • Список названий цвета CSS см. в разделе https://www.crockford.com/wrrrld/color.html.

  • Чтобы задать шестнадцатеричный формат RGB, используйте # в качестве первого символа и двухзначных шестнадцатеричных чисел для красных, зеленых и синих значений. Для примера, '#0000ff' задает синий цвет.

Горизонтальное выравнивание содержимого записи таблицы в виде вектора символов или строкового скаляра. Задайте одно из значений в таблице.

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

'center'

Сосредоточенный

'left'

Обосновано слева

'right'

Обоснованные по праву

'justified'

Левое и правое обоснование, разделение слов равномерно

'distributed'

Выравнивание букв по левому и правому краю равномерно

'thaiDistributed'

Оправданный влево и вправо тайский текст, разделяющий символы равномерно

'justifiedLow'

Обоснование текста на арабском языке

Вертикальное выравнивание содержимого записи таблицы в виде вектора символов или строкового скаляра. Задайте одно из значений в таблице.

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

'top'

Вертикально выровнено по верхней части

'bottom'

Вертикально выровнено по нижней части записи таблицы

'middle'

Вертикально выровнено по середине записи таблицы

'topCentered'

Вертикальное выравнивание по верхней части и горизонтальное выравнивание по центру записи таблицы

'bottomCentered'

Вертикально выровнено по дну и горизонтально выровнено по центру записи таблицы

'middleCentered'

Вертикальное выравнивание по середине и горизонтальное выравнивание по центру записи таблицы

Ориентация текста записи таблицы, заданная как вектор символов или строковый скаляр. Задайте одно из значений в таблице.

ЗначениеОписание
'horizontal'Ориентация текста горизонтальна.
'down'Ориентация текста вертикальна, содержимое повернуто на 90 степени, по часовой стрелке.
'up'Ориентация текста вертикальна, содержимое повернуто на 90 степени против часовой стрелки.

Количество столбцов, охватываемых этой записью таблицы, заданное как double.

Чтобы создать таблицу с записью, которая охватывает несколько столбцов, создайте таблицу из mlreportgen.ppt.TableEntry и mlreportgen.ppt.TableRow объекты. См. раздел «Создание записей таблицы, охватывающих несколько столбцы». В строке, содержащей запись, охватывающую столбцы, задайте запись для первого столбца диапазона. Не задавайте значения для других столбцов диапазона.

Запись, охватывающая столбцы, имеет общую границу с записью, расположенной в строке ниже и в первом столбце диапазона. Нижняя граница покрывающего элемента определяет стиль общей границы. В строке, содержащей покрывающую запись, значения для второго-последнего столбцов диапазона не определены. Верхние границы соответствующих записей в строке ниже определяют границы под неопределенными записями. Чтобы задать границу под покрывающей записью для всего диапазона столбцов:

  • Задайте нижнюю границу записи, которая охватывает столбцы.

  • В следующей строке укажите верхние границы значений во втором - последнем столбцах диапазона.

Для получения примера смотрите Настроить нижнюю границу входа, которая охватывает несколько Столбцы.

Количество строк, охватываемых этой записью таблицы, заданное как double.

Чтобы создать таблицу с записью, которая охватывает несколько строк, создайте таблицу из mlreportgen.ppt.TableEntry и mlreportgen.ppt.TableRow объекты. Смотрите раздел Создание записей таблицы, которые охватывают несколько строк. В столбце, содержащем запись, охватывающую строки, задайте запись для первой строки диапазона. Не задавайте значения для других строк в диапазоне.

Запись, которая охватывает строки, имеет общую границу с записью, которая находится в столбце справа и в первой строке диапазона. Стиль общей границы определяется правой границей охватывающего элемента. В столбце, содержащем покрывающую запись, значения для вторых и последних строк диапазона не определены. Левые границы соответствующих записей в столбце справа определяют правые границы неопределенных записей. Чтобы задать правую границу покрывающей записи для всего диапазона строк:

  • Задайте правую границу записи, которая охватывает строки.

  • В следующем столбце укажите левые границы значений во второй - последней строках диапазона.

Для получения примера см. раздел «Настройка правой границы входа, которая охватывает несколько строк».

Стиль границы входа в таблицу, заданный как вектор символов или строковый скаляр. Задайте одно из следующих значений:

  • 'none'

  • 'solid'

  • 'dot'

  • 'dash'

  • 'largeDash'

  • 'dashDot'

  • 'largeDashDot'

  • 'largeDashDotDot'

  • 'systemDash'

  • 'systemDot'

  • 'systemDashDot'

  • 'systemDashDotDot'

Конфликт возникает, если сегмент границы является общим для двух записей таблицы. Для конфликтующего горизонтального сегмента границы PowerPoint игнорирует форматы, заданные записью внизу. Для конфликтующего вертикального сегмента границы PowerPoint игнорирует форматы, заданные записью справа.

Цвет границы входа в таблицу, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS или шестнадцатеричного значения RGB.

  • Список названий цвета CSS см. в разделе https://www.crockford.com/wrrrld/color.html.

  • Чтобы задать шестнадцатеричный формат RGB, используйте # в качестве первого символа и двухзначных шестнадцатеричных чисел для красных, зеленых и синих значений. Для примера, '#0000ff' задает синий цвет.

Ширина границы входа в таблицу, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера, '3pt' задает три точки. Допустимые сокращения:

  • px - пиксели (по умолчанию)

  • cm - сантиметров

  • in - дюймы

  • mm - миллиметры

  • pc - picas

  • pt - точки

Форматирование записи таблицы, заданное как массив ячеек объектов формата PPT. Форматы, которые не применяются к TableEntry объект игнорируется.

Дочерние элементы этого объекта, заданные как массив ячеек объектов PPT. Это свойство доступно только для чтения.

Родительский элемент этого объекта, заданный как объект PPT. Это свойство доступно только для чтения.

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

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

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

Методы

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

Примеры

свернуть все

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

Создайте презентацию.

import mlreportgen.ppt.*
ppt = Presentation('myTableRowPresentation.pptx');
open(ppt);

Добавьте слайд к презентации.

add(ppt,'Title and Content');

Составьте таблицу.

table = Table();

Создайте первую строку таблицы.

tr1 = TableRow();
tr1.Style = [tr1.Style {Bold(true)}];

Создайте записи таблицы для первой строки.

te1tr1 = TableEntry();
p = Paragraph('first entry');
p.FontColor = 'red';
append(te1tr1,p);
append(tr1,te1tr1);

te2tr1 = TableEntry();
append(te2tr1,'second entry');
append(tr1,te2tr1);

te3tr1 = TableEntry();
te3tr1.FontColor = 'green';
append(te3tr1,'third entry');
append(tr1,te3tr1);

Добавьте первую строку таблицы к таблице.

append(table,tr1);

Создайте вторую строку таблицы, добавьте записи таблицы к строке и добавьте строку к таблице.

tr2 = TableRow();
te1tr2 = TableEntry();
te1tr2.FontColor ='red';
p = Paragraph('first entry');
append(te1tr2,p);
append(tr2,te1tr2);

te2tr2 = TableEntry();
append(te2tr2,'second entry');
append(tr2,te2tr2);

te3tr2 = TableEntry();
te3tr2.FontColor = 'green';
append(te3tr2,'third entry');
append(tr2,te3tr2);
append(table,tr2);

Добавьте таблицу к презентации.

contents = find(ppt,'Content');
replace(contents(1),table);
 

Закройте и просмотрите презентацию.

close(ppt);
rptview(ppt);

Вот таблица в сгенерированной презентации:

Используйте ColSpan свойство, чтобы указать, что запись таблицы охватывает несколько столбцов.

Создайте презентацию.

import mlreportgen.ppt.*
ppt = Presentation("myColSpan.pptx");
open(ppt);

Добавьте слайд к презентации.

slide = add(ppt,"Title and Table");

Составьте таблицу с четырьмя столбцами.

t = Table(4);
t.StyleName = "Medium Style 2 - Accent 1";
t.Style = {VAlign("middleCentered")};

Создайте строку заголовка. Эта строка имеет одну запись таблицы, которая охватывает все четыре столбца.

tr1 = TableRow();
tr1te1 = TableEntry("Header Row");
tr1te1.ColSpan = 4;
append(tr1,tr1te1);
append(t,tr1);

Создайте строку подзаголовка. Эта строка имеет две записи таблицы, каждая из которых охватывает два столбца.

tr2 = TableRow();
tr2te1 = TableEntry("Subheader 1");
tr2te1.ColSpan = 2;
append(tr2,tr2te1);
tr2te2 = TableEntry("Subheader 2");
tr2te2.ColSpan = 2;
append(tr2,tr2te2);
append(t,tr2);

Создайте строку содержимого. Эта строка имеет четыре записи таблицы, каждая из которых охватывает один столбец.

tr3 = TableRow();
append(tr3,TableEntry("entry(1,1)"));
append(tr3,TableEntry("entry(1,2)"));
append(tr3,TableEntry("entry(1,3)"));
append(tr3,TableEntry("entry(1,4)"));
append(t,tr3);

Добавить заголовок и таблицу на слайд.

replace(slide,"Title","Table Entry That Spans Multiple Columns");
replace(slide,"Table",t);

Закройте и просмотрите презентацию.

close(ppt);
rptview(ppt);

Вот слайд в сгенерированной презентации:

Используйте строку Span свойство, чтобы указать, что запись таблицы охватывает несколько строк.

Создайте презентацию.

import mlreportgen.ppt.*
ppt = Presentation("myRowSpan.pptx");
open(ppt);

Добавьте слайд к презентации.

slide = add(ppt,"Title and Table");

Составьте таблицу с тремя столбцами.

t = Table(3);
t.Style = [t.Style {VAlign("middleCentered")}];

Создайте первую строку таблицы.

tr1 = TableRow();

Создайте запись в первом столбце, которая охватывает все четыре строки.

tr1te1 = TableEntry("Header Column");
tr1te1.RowSpan = 4;
append(tr1,tr1te1);

Создайте запись во втором столбце, которая охватывает первые две строки.

tr1te2 = TableEntry("Subheader 1");
tr1te2.RowSpan = 2;
append(tr1,tr1te2);

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

append(tr1,TableEntry("entry(1,1)"));
append(t,tr1);

Создайте вторую строку таблицы. Создайте запись в третьем столбце. Значения в первом и втором столбцах уже определены, поскольку значения в первом и втором столбцах охватывают первые две строки.

tr2 = TableRow();
append(tr2,TableEntry("entry(2,1)"));
append(t,tr2);

Создайте третью строку таблицы и введите значения для второго и третьего столбцов. Запись во втором столбце состоит из двух строк. Первый столбец уже определен, поскольку строка 1, столбец 1 охватывает все строки.

tr3 = TableRow();
tr3te2 = TableEntry("Subheader 2");
tr3te2.RowSpan = 2;
append(tr3,tr3te2);
append(tr3,TableEntry("entry(3,1)"));
append(t,tr3);

Создайте четвертую строку таблицы. Запись создается только для третьего столбца. Значения первого и второго столбцов уже заданы предыдущими строками, охватывающими несколько столбцов.

tr4 = TableRow();
append(tr4,TableEntry("entry(4,1)"));
append(t,tr4);

Добавить заголовок и таблицу на слайд.

replace(slide,"Title","Table Entry That Spans Multiple Rows");
replace(slide,"Table",t);

Закройте и просмотрите презентацию.

close(ppt);
rptview(ppt);

Вот слайд в сгенерированной презентации:

Чтобы настроить нижнюю границу записи, охватывающей несколько столбцов:

  • Задайте нижнюю границу записи, которая охватывает столбцы. Эта спецификация определяет границу, которая является общей с записью в следующей строке, которая находится в первом столбце диапазона.

  • В следующей строке укажите верхние границы значений в остальных столбцах диапазона.

Этот пример задает таблицу, которая имеет две строки и три столбца. Запись в строке 1 и столбце 1 охватывает три столбца. Чтобы сделать нижнюю границу этой записи красной по всему диапазону, пример задает, что:

  • Нижняя граница строки 1, столбец 1 - красная.

  • Верхние границы строки 2, столбца 2 и строки 2, столбца 3 - красные.

Создайте презентацию.

import mlreportgen.ppt.*
ppt = Presentation("myColSpanBorder.pptx");
open(ppt);

Добавьте слайд к презентации.

slide = add(ppt,"Title and Table");

Составьте таблицу с тремя столбцами.

t = Table(3);
t.Style = [t.Style {VAlign("middleCentered")}];

Создайте первую строку таблицы.

tr1 = TableRow();

Создайте первую запись первой строки и укажите, что запись охватывает три столбца. Задайте, что нижняя граница входа красная. Добавьте запись к строке.

te11 = TableEntry("entry 1,1");
te11.ColSpan = 3;
border = Border();
border.BottomColor = 'red';
te11.Style = [te11.Style {border}];
append(tr1,te11);

Создайте вторую строку таблицы.

tr2 = TableRow();

Создайте первую запись второй строки и добавьте запись к строке. Верхняя граница этой записи определяется нижней границей строки 1, столбца 1.

te21 = TableEntry("entry 2,1");
append(tr2,te21);

Создайте вторую запись второй строки, укажите, что верхняя граница красная, и добавьте запись к строке.

te22 = TableEntry("entry 2,2");
b = Border();
b.TopColor = 'red';
te22.Style = [te22.Style {b}];
append(tr2,te22);

Создайте третью запись второй строки, укажите, что верхняя граница красная, и добавьте запись к строке.

te23 = TableEntry("entry 2,3");
b = Border();
b.TopColor = 'red';
te23.Style = [te23.Style {b}];
append(tr2,te23);

Добавьте строки к таблице.

append(t,tr1);
append(t,tr2);

Добавить заголовок и таблицу на слайд.

replace(slide,"Title","Table Entry That Spans Multiple Columns");
replace(slide,"Table",t);

Закройте и просмотрите презентацию.

close(ppt);
rptview(ppt);

Нижняя граница входа первой строки красна по всему диапазону.

Чтобы настроить правую границу записи, охватывающей несколько строк:

  • Задайте правую границу записи, которая охватывает строки. Эта спецификация определяет границу, которая является общей с записью в следующем столбце, который находится в первой строке диапазона.

  • В следующем столбце укажите левую границу значений в остальных строках диапазона.

Этот пример задает таблицу, которая имеет две строки и два столбца. Запись в строке 1 и столбце 1 охватывает две строки. Чтобы сделать правую границу этой записи красной по всему диапазону, пример задает, что:

  • Правая граница строки 1, столбец 1 - красная.

  • Левая граница строки 2, значение в столбце 2 красное.

Создайте презентацию.

import mlreportgen.ppt.*
ppt = Presentation("myRowSpanBorder.pptx");
open(ppt);

Добавьте слайд к презентации.

slide = add(ppt,"Title and Table");

Составьте таблицу с двумя столбцами.

t = Table(2);
t.Style = [t.Style {VAlign("middleCentered")}];

Создайте первую строку таблицы.

tr1 = TableRow();

Создайте первую запись первой строки и укажите, что запись охватывает две строки. Задайте, что правая граница входа красная. Добавьте запись к строке.

te11 = TableEntry("entry 1,1");
te11.RowSpan = 2;
border = Border();
border.RightColor = 'red';
te11.Style = [te11.Style {border}];
append(tr1,te11);

Создайте вторую запись первой строки и добавьте запись к строке. Левая граница этой записи определяется правой границей строки 1, столбца 1.

te12 = TableEntry("entry 1,2");
append(tr1,te12);

Создайте вторую запись второй строки, укажите, что левая граница красная, и добавьте запись к строке.

tr2 = TableRow();
te22 = TableEntry("entry 2,2");
b = Border();
b.LeftColor = 'red';
te22.Style = [te22.Style {b}];
append(tr2,te22);

Добавьте строки к таблице.

append(t,tr1);
append(t,tr2);

Добавить заголовок и таблицу на слайд.

replace(slide,"Title","Table Entry That Spans Multiple Rows");
replace(slide,"Table",t);

Закройте и просмотрите презентацию.

close(ppt);
rptview(ppt);

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

Введенный в R2015b