mlreportgen.ppt.Table class

Пакет: mlreportgen.ppt

Таблица в презентации

Описание

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

Составьте таблицу с помощью одного из следующих подходов:

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

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

После создания таблицы можно добавить строки в таблицу и добавить записи в каждую строку таблицы.

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

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

HandleCompatible
true
ConstructOnLoad
true

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

Создание

Описание

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

tableObj = mlreportgen.ppt.Table(nCols) устанавливает свойство NCols на nCols.

пример

tableObj = mlreportgen.ppt.Table(tableValues) возвращает таблицу, содержимое которой задано как tableValues.

tableObj = mlreportgen.ppt.Table(tableValues,styleName) возвращает таблицу, которая имеет заданное содержимое и устанавливает свойство StyleName равным styleName. Чтобы получить список допустимых имен стилей, используйте getTableStyleNames метод mlreportgen.ppt.Presentation объект.

Входные параметры

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

Значения таблицы, заданные как двумерный числовой массив, категориальный массив или массив ячеек из чисел, векторов символов, строковых скаляров или mlreportgen.ppt.Paragraph объекты.

Свойства

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

Количество столбцов таблицы в виде целого числа. Это свойство доступно только для чтения. Чтобы задать количество столбцов, составьте таблицу с помощью синтаксиса mlreportgen.ppt.Table(nCols). В противном случае Table конструктор определяет количество столбцов из содержимого таблицы. Если вы добавляете строки в таблицу или записи в строку, и количество столбцов изменяется, NCols значение свойства обновляется. Если строки не все имеют одинаковое количество записей, строка с наибольшим количеством записей таблицы определяет количество столбцов в таблице.

Имя стиля таблицы, заданное как вектор символов или строковый скаляр. Чтобы получить список допустимых имен стилей, используйте getTableStyleNames метод mlreportgen.ppt.Presentation объект.

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

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

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

Массив mlreportgen.ppt.ColSpec объекты, задающие ширину, выравнивание и другие свойства форматирования столбцов таблицы. Первый объект применяется к первому столбцу, второй - ко второму столбцу и так далее.

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

  • 'LeftToRight' - Порядок столбцов слева направо

  • 'RightToLeft' - Порядок столбцов справа налево

См. Порядок таблица Столбцов.

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

  • 'none'

  • 'solid'

  • 'dot'

  • 'dash'

  • 'largeDash'

  • 'dashDot'

  • 'largeDashDot'

  • 'largeDashDotDot'

  • 'systemDash'

  • 'systemDot'

  • 'systemDashDot'

  • 'systemDashDotDot'

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

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

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

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

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

  • 'none'

  • 'solid'

  • 'dot'

  • 'dash'

  • 'largeDash'

  • 'dashDot'

  • 'largeDashDot'

  • 'largeDashDotDot'

  • 'systemDash'

  • 'systemDot'

  • 'systemDashDot'

  • 'systemDashDotDot'

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

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

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

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

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

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

  • 'none'

  • 'solid'

  • 'dot'

  • 'dash'

  • 'largeDash'

  • 'dashDot'

  • 'largeDashDot'

  • 'largeDashDotDot'

  • 'systemDash'

  • 'systemDot'

  • 'systemDashDot'

  • 'systemDashDotDot'

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

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

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

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

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

Семейство шрифтов для текста в этой таблице, заданное как вектор символов или строковый скаляр. Укажите шрифт, который отображается в списке шрифтов в 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 - точки

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

Верхняя левая координата X положения таблицы, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует единица измерения. Для примера, '5in' задает 5 дюймов. Допустимые сокращения:

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

Верхняя левая y-координата положения таблицы, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует единица измерения. Для примера, '5in' задает 5 дюймов. Допустимые сокращения:

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

Ширина таблицы, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера, '5in' задает пять дюймов. Допустимые сокращения:

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

Высота таблицы, заданная как вектор символов или строковый скаляр, который состоит из числа, за которым следует сокращение для единицы измерения. Для примера, '5in' задает пять дюймов. Допустимые сокращения:

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

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

  • in - дюймы

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

  • pc - picas

  • pt - точки

Если задана высота таблицы, а высота строки не задана ни для одной строки, высота всех строк совпадает. Высота строки определяется путем деления высоты таблицы на количество строк. Если высота задана хотя бы для одной строки, PPT API игнорирует высоту таблицы. Microsoft PowerPoint определяет высоту строк, для которых высота не задана.

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

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

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

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

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

ID для этого объекта 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);

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

Введенный в R2015b