Пакет: mlreportgen.ppt
Таблица в презентации
Используйте объект mlreportgen.ppt.Table
Класс для включения таблицы в презентацию PPT API.
Составьте таблицу с помощью одного из следующих подходов:
Создайте пустую таблицу и добавьте строки таблицы, которые имеют записи таблицы для каждого столбца.
Составьте таблицу из массива или массива ячеек, который задает содержимое таблицы.
После создания таблицы можно добавить строки в таблицу и добавить записи в каждую строку таблицы.
The mlreportgen.ppt.Table
класс является handle
класс.
HandleCompatible | true |
ConstructOnLoad | true |
Для получения информации об атрибутах класса см. раздел «Атрибуты класса».
создает пустой tableObj
= mlreportgen.ppt.Table()Table
объект.
устанавливает свойство NCols на tableObj
= mlreportgen.ppt.Table(nCols)nCols
.
возвращает таблицу, содержимое которой задано как tableObj
= mlreportgen.ppt.Table(tableValues
)tableValues
.
возвращает таблицу, которая имеет заданное содержимое и устанавливает свойство StyleName равным tableObj
= mlreportgen.ppt.Table(tableValues
,styleName
)styleName
. Чтобы получить список допустимых имен стилей, используйте getTableStyleNames
метод mlreportgen.ppt.Presentation
объект.
tableValues
- Табличные значенияЗначения таблицы, заданные как двумерный числовой массив, категориальный массив или массив ячеек из чисел, векторов символов, строковых скаляров или mlreportgen.ppt.Paragraph
объекты.
NCols
- Количество столбцов таблицыКоличество столбцов таблицы в виде целого числа. Это свойство доступно только для чтения. Чтобы задать количество столбцов, составьте таблицу с помощью синтаксиса mlreportgen.ppt.Table(nCols)
. В противном случае Table
конструктор определяет количество столбцов из содержимого таблицы. Если вы добавляете строки в таблицу или записи в строку, и количество столбцов изменяется, NCols
значение свойства обновляется. Если строки не все имеют одинаковое количество записей, строка с наибольшим количеством записей таблицы определяет количество столбцов в таблице.
StyleName
- Имя стиля таблицы[]
(по умолчанию) | символьный вектор | строковый скалярИмя стиля таблицы, заданное как вектор символов или строковый скаляр. Чтобы получить список допустимых имен стилей, используйте getTableStyleNames
метод mlreportgen.ppt.Presentation
объект.
BackgroundColor
- Цвет фона таблицы[]
(по умолчанию) | символьный вектор | строковый скалярЦвет фона таблицы, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS или шестнадцатеричного значения RGB.
Список названий цвета CSS см. в разделе https://www.crockford.com/wrrrld/color.html.
Чтобы задать шестнадцатеричный формат RGB, используйте #
в качестве первого символа и двухзначных шестнадцатеричных чисел для красных, зеленых и синих значений. Для примера, '#0000ff'
задает синий цвет.
ColSpecs
- Объекты формата столбца таблицы[]
(по умолчанию) | массив mlreportgen.ppt.ColSpec
объектыМассив mlreportgen.ppt.ColSpec
объекты, задающие ширину, выравнивание и другие свойства форматирования столбцов таблицы. Первый объект применяется к первому столбцу, второй - ко второму столбцу и так далее.
FlowDirection
- Направление потока столбца таблицы[]
(по умолчанию) | 'LeftToRight'
| 'RightToLeft'
Направление потока столбца таблицы, заданное как вектор символов или строковый скаляр. Задайте одно из следующих значений:
'LeftToRight'
- Порядок столбцов слева направо
'RightToLeft'
- Порядок столбцов справа налево
Border
- Стиль границы'solid'
(по умолчанию) | 'none'
| 'dot'
| ...Стиль границы, заданный как вектор символов или строковый скаляр. Задайте одно из следующих значений:
'none'
'solid'
'dot'
'dash'
'largeDash'
'dashDot'
'largeDashDot'
'largeDashDotDot'
'systemDash'
'systemDot'
'systemDashDot'
'systemDashDotDot'
BorderColor
- Цвет границы'black'
(по умолчанию) | символьный вектор | строковый скалярЦвет границы, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS или шестнадцатеричного значения RGB.
Список названий цвета CSS см. в разделе https://www.crockford.com/wrrrld/color.html.
Чтобы задать шестнадцатеричный формат RGB, используйте #
в качестве первого символа и двухзначных шестнадцатеричных чисел для красных, зеленых и синих значений. Для примера, '#0000ff'
задает синий цвет.
BorderWidth
- Ширина границы'1pt'
(по умолчанию) | символьный вектор | строковый скалярШирина границы, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера, '3pt'
задает три точки. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
ColSep
- Стиль диафрагмы столбцов'solid'
(по умолчанию) | 'none'
| 'dot'
| ...Стиль диафрагмы столбцов, заданный как вектор символов или строковый скаляр. Задайте одно из следующих значений:
'none'
'solid'
'dot'
'dash'
'largeDash'
'dashDot'
'largeDashDot'
'largeDashDotDot'
'systemDash'
'systemDot'
'systemDashDot'
'systemDashDotDot'
ColSepColor
- Цвет диафрагмы столбцов'black'
(по умолчанию) | символьный вектор | строковый скалярЦвет диафрагмы столбца, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS или шестнадцатеричного значения RGB.
Список названий цвета CSS см. в разделе https://www.crockford.com/wrrrld/color.html.
Чтобы задать шестнадцатеричный формат RGB, используйте #
в качестве первого символа и двухзначных шестнадцатеричных чисел для красных, зеленых и синих значений. Для примера, '#0000ff'
задает синий цвет.
ColSepWidth
- Ширина диафрагмы столбцов'1pt'
(по умолчанию) | символьный вектор | строковый скалярШирина диафрагмы столбца, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера, '3pt'
задает три точки. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
RowSep
- Стиль диафрагмы строк'solid'
(по умолчанию) | 'none'
| 'dot'
| ...Стиль диафрагмы строк, заданный как вектор символов или строковый скаляр. Задайте одно из следующих значений:
'none'
'solid'
'dot'
'dash'
'largeDash'
'dashDot'
'largeDashDot'
'largeDashDotDot'
'systemDash'
'systemDot'
'systemDashDot'
'systemDashDotDot'
RowSepColor
- Цвет диафрагмы строк'black'
(по умолчанию) | символьный вектор | строковый скалярЦвет диафрагмы строки, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS или шестнадцатеричного значения RGB.
Список названий цвета CSS см. в разделе https://www.crockford.com/wrrrld/color.html.
Чтобы задать шестнадцатеричный формат RGB, используйте #
в качестве первого символа и двухзначных шестнадцатеричных чисел для красных, зеленых и синих значений. Для примера, '#0000ff'
задает синий цвет.
RowSepWidth
- Ширина диафрагмы строк'1pt'
(по умолчанию) | символьный вектор | строковый скалярШирина диафрагмы строка, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера, '3pt'
задает три точки. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Font
- Семейство шрифтов для текста в этой таблице []
(по умолчанию) | символьный вектор | строковый скалярСемейство шрифтов для текста в этой таблице, заданное как вектор символов или строковый скаляр. Укажите шрифт, который отображается в списке шрифтов в Microsoft® PowerPoint®. Чтобы увидеть список шрифтов, в PowerPoint, на вкладке Home, в группе Font, щелкните стреле справа от шрифта.
ComplexScriptFont
- Семейство шрифтов для сложных скриптов[]
(по умолчанию) | символьный вектор | строковый скалярСемейство шрифтов для сложных скриптов, заданное как вектор символов или строковый скаляр. Задайте семейство шрифтов, которые будут использоваться при подстановке в локали, которая требует сложного скрипта, такого как арабский или азиатский, для визуализации текста.
FontColor
- Цвет шрифта для текста в этой таблице[]
(по умолчанию) | символьный вектор | строковый скалярЦвет шрифта для текста в этой таблице, заданный как вектор символов или строковый скаляр, который состоит из названия цвета CSS или шестнадцатеричного значения RGB.
Список названий цвета CSS см. в разделе https://www.crockford.com/wrrrld/color.html.
Чтобы задать шестнадцатеричный формат RGB, используйте #
в качестве первого символа и двухзначных шестнадцатеричных чисел для красных, зеленых и синих значений. Для примера, '#0000ff'
задает синий цвет.
FontSize
- Размер шрифта текста в этой таблице[]
(по умолчанию) | символьный вектор | строковый скалярРазмер шрифта текста в этой таблице, заданный как вектор символов или строковый скаляр, который состоит из числа, за которым следует единица измерения. Для примера, '11pt'
задает 11 точек. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Name
- Имя таблицы''
(по умолчанию) | символьный вектор | строковый скалярИмя таблицы, заданное как вектор символов или строковый скаляр.
X
- Верхняя левая x-координата положения таблицы[]
(по умолчанию) | символьный вектор | строковый скалярВерхняя левая координата X положения таблицы, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует единица измерения. Для примера, '5in'
задает 5 дюймов. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Y
- Верхняя левая y-координата положения таблицы[]
(по умолчанию) | символьный вектор | строковый скалярВерхняя левая y-координата положения таблицы, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует единица измерения. Для примера, '5in'
задает 5 дюймов. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Width
- Ширина таблицы[]
(по умолчанию) | символьный вектор | строковый скалярШирина таблицы, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера, '5in'
задает пять дюймов. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Height
- Высота таблицы[]
(по умолчанию) | символьный вектор | строковый скалярВысота таблицы, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера, '5in'
задает пять дюймов. Допустимые сокращения:
px
- пиксели (по умолчанию)
cm
- сантиметров
in
- дюймы
mm
- миллиметры
pc
- picas
pt
- точки
Если задана высота таблицы, а высота строки не задана ни для одной строки, высота всех строк совпадает. Высота строки определяется путем деления высоты таблицы на количество строк. Если высота задана хотя бы для одной строки, PPT API игнорирует высоту таблицы. Microsoft PowerPoint определяет высоту строк, для которых высота не задана.
Style
- Форматирование таблицыФорматирование таблицы, заданное как массив ячеек объектов формата PPT. Форматы, которые не применяются к Table
объект игнорируется.
Children
- Дочерние элементы этого объекта PPT APIДочерние элементы этого объекта, заданные как массив ячеек объектов PPT. Это свойство доступно только для чтения.
Parent
- Родительский элемент этого объекта PPT APIРодительский элемент этого объекта, заданный как объект PPT. Это свойство доступно только для чтения.
Tag
- Тег для этого объекта PPT APIТег для этого объекта PPT API, заданный как вектор символов или строковый скаляр. Тег, уникальный для сеанса, генерируется как часть создания этого объекта. Сгенерированный тег имеет форму CLASS:ID
, где CLASS
- класс объектов и ID
- значение Id
свойство объекта.
Установка собственного значения тега может помочь вам определить, где произошла проблема во время генерации презентации.
Id
- идентификатор для этого объекта PPT APIID для этого объекта PPT API, заданный как вектор символов или строковый скаляр. Уникальный для сеанса идентификатор генерируется как часть создания объекта. Можно задать идентификатор для замены сгенерированного идентификатора.
Использование mlreportgen.ppt.Table
объекты для включения таблиц в презентацию.
Создайте презентацию.
import mlreportgen.ppt.* ppt = Presentation('myTablePresentation.pptx'); open(ppt); slide1 = add(ppt,'Title and Table'); slide2 = add(ppt,'Title and Table');
Составьте таблицу из массива ячеек.
table1 = Table({'a','b';'c','d'}); table1.Children(1).FontColor = 'red'; table1.Children(2).FontColor = 'green';
Используйте find
метод для поиска слайдов, имеющих объекты с Name
значение свойства установлено в Table
. PPT API по умолчанию Title and Table
компоновочный слайд имеет Table
объект.
contents = find(ppt,'Table');
Замените содержимое первого слайда на table1
.
replace(contents(1),table1);
Составьте вторую таблицу из вывода magic
MATLAB ® функция.
table2 = Table(magic(9));
Замените содержимое второго слайда на table2
.
replace(contents(2),table2);
Закройте и просмотрите презентацию.
close(ppt); rptview(ppt);
Вот слайды в сгенерированной презентации:
Чтобы задать порядок столбцов таблицы в презентации, используйте FlowDirection
свойство Table
объект.
Создайте презентацию.
import mlreportgen.ppt.* ppt = Presentation('myFlowDirection.pptx'); open(ppt);
Добавить слайд к презентации.
slide = add(ppt,'Title and Content');
Составьте таблицу и задайте направление потока таблицы.
t = Table({'entry(1,1)','entry(1,2)';'entry(2,1)','entry(2,2)'}); t.FlowDirection = 'RightToLeft';
Добавьте слайд к таблице.
replace(slide,'Content',t);
Закройте и просмотрите презентацию.
close(ppt); rptview(ppt);
Вот слайд в сгенерированной презентации:
mlreportgen.ppt.TableEntry
| mlreportgen.ppt.TablePlaceholder
| mlreportgen.ppt.TableRow
| mlreportgen.ppt.TemplateTable
У вас есть измененная версия этого примера. Вы хотите открыть этот пример с вашими правками?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.