exponenta event banner

mlreportgen.ppt.Table class; класс таблицы

Пакет: mlreportgen.ppt

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

Описание

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

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

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

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

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

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 - пикас

  • 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 - пикас

  • 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 - пикас

  • pt - точки

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

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

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

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

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

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

  • in - дюймы

  • mm - миллиметров

  • pc - пикас

  • pt - точки

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

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

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

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

Тег для этого объекта PPT API, указанный как вектор символов или строковый скаляр. Уникальный для сеанса тег создается как часть создания этого объекта. Созданный тег имеет форму CLASS:ID, где CLASS является классом объекта и 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. API PPT по умолчанию Title and Table слайд макета имеет Table объект.

contents = find(ppt,'Table');

Заменить содержимое первого слайда на table1.

replace(contents(1),table1);

Создайте вторую таблицу из выходных данных MATLAB ®magic функция.

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