Создайте и таблицы формата

Составление таблицы

Чтобы составить таблицу, вы можете:

  • Создайте пустой Table объект с помощью mlreportgen.ppt.Table конструктор без аргументов. Затем добавьте TableRow объекты к Table возразите и добавьте TableEntry объекты к TableRow объекты.

  • Создайте пустой Table объект с помощью mlreportgen.ppt.Table конструктор, задавая количество столбцов.

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

Для примера составления таблицы путем добавления строк таблицы к пустой таблице смотрите mlreportgen.ppt.TableRow. Для примера составления таблицы путем определения значений в конструкторе Объекта таблицы смотрите mlreportgen.ppt.Table.

Отформатируйте таблицу

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

Стили таблицы в шаблонах

Шаблон PowerPoint® должен содержать экземпляр стиля таблицы для вас, чтобы использовать его в программе API PPT. Чтобы перечислить экземпляры стилей таблицы в вашем шаблоне, используйте getTableStyleNames.

import mlreportgen.ppt.*

%% Create a new presentation and open it
slides = Presentation('myPrsentation');
open(slides);

%% Print out all table styles and
%% their universally unique identifiers (UUID)
pptStyles = getTableStyleNames(slides);
fprintf('Available table styles:\n');
for i = 1:length(pptStyles)
    fprintf('    Style name: ''%s''\n', pptStyles{i,1});
    fprintf('          UUID: ''%s''\n', pptStyles{i,2});
end

%% Close the presentation
close(slides);

Каждый возвращенный стиль имеет имя и ID. Можно использовать имя или ID с Style свойство. Используйте ID, когда имя сможет варьироваться на основе локали.

Available table styles:
    Style name: 'Medium Style 2 - Accent 1'
          UUID: '{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}'
    Style name: 'Light Style 1'
          UUID: '{9D7B26C5-4107-4FEC-AEDC-1716B250A1EF}'
    Style name: 'Light Style 1 - Accent 1'
          UUID: '{3B4B98B0-60AC-42C2-AFA5-B58CD77FA1E5}'
    Style name: 'Light Style 1 - Accent 2'
          UUID: '{0E3FDE45-AF77-4B5C-9715-49D594BDF05E}'

Если имя стиля, который вы хотите использовать, не имеет экземпляра, создает тот.

  1. Создайте понижение в своем шаблоне PowerPoint.

  2. В понижении составьте таблицу.

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

  4. Удалите понижение, и сохраните и закройте шаблон.

Отформатируйте таблицу Используя стиль таблицы

В этом примере показано, как отформатировать таблицу с помощью стиля таблицы.

import mlreportgen.ppt.*

%% Create a new presentation and add two slides to it
slides = Presentation();
add(slides,'Title and Content');
add(slides,'Title and Content');


%% Save the two content placeholders named 'Content' in an array. 
%% Replace the first content placeholder with a 5x5 table and 
%% apply a table style to it. 
contents = find(slides,'Content');
tbl = replace(contents(1),Table(magic(5)));
tbl.StyleName = 'Medium Style 2 - Accent 1'

%% Replace the second content placeholder with a 10x10 table and 
%% apply a different table style.
%% Generate the presentation and open  it. 
tbl = replace(contents(2),Table(magic(10)));
tbl.StyleName = 'Medium Style 2 - Accent 2'
close(slides);

if ispc
    winopen(slides.OutputPath);
end

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

Параметры форматирования

Можно задать местоположение (верхние левые координаты X и Y), высота и свойства ширины таблицы. Когда вы добавляете таблицу в представление программно, PowerPoint использует те свойства, если все табличное содержимое помещается в таблицу. Когда вы заменяете TablePlaceholder или ContentPlaceholder с таблицей PowerPoint приспосабливает таблицу в месте заполнителя и размерностях.

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

Можно задать эти параметры форматирования по умолчанию для содержимого Table объект.

Table Объектное форматирование Объект форматаСвойство формата

Стиль таблицы из шаблона

Используйте шаблон PowerPoint, чтобы задать форматирование стиля таблицы. Создайте экземпляр стиля в вашем шаблоне.

нет данных

StyleName

BackgroundColor

BackgroundColor

BackgroundColor

Форматирование столбца

ColSpec

ColSpecs

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

VAlign

VAlign

Семейство шрифтов

FontFamily

Font

Семейство шрифтов для комплексных скриптов, чтобы обработать локали

FontFamily

ComplexScriptFont

'FontSize'

FontSize

FontSize

FontColor

FontColor

FontColor

Верхняя левая x-координата таблицы

нет данных

X

Верхняя левая y-координата таблицы

нет данных

Y

Таблица width

нет данных

Width

Табличная высота

нет данных

Height

Задавать форматирование значения по умолчанию для содержимого TableRow объект, используйте Style свойство с этими объектами формата.

TableRow Объектное форматирование Объект форматаСвойство формата

BackgroundColor

BackgroundColor

нет данных

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

VAlign

нет данных

Семейство шрифтов

FontColor

нет данных

Семейство шрифтов для комплексных скриптов

FontFamily

нет данных

'FontSize'

FontSize

нет данных

TextColor

FontColor

нет данных

Полужирный

Bold

нет данных

Курсив

Italic

нет данных

Забастовка

Strike

нет данных

Подчеркивание

Underline

нет данных

BackgroundColor

BackgroundColor

нет данных

Задавать форматирование значения по умолчанию для содержимого TableEntry объект, используйте эти параметры форматирования.

TableEntry Объектное форматирование Объект форматаСвойство формата

BackgroundColor

BackgroundColor

BackgroundColor

ColumnWidth

ColWidth

нет данных

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

VAlign

VAlign

Семейство шрифтов

FontFamily

Font

Семейство шрифтов для комплексных скриптов, чтобы обработать локали

FontFamily

ComplexScriptFont

TextColor

FontColor

FontColor

'FontSize'

FontSize

FontSize

Полужирный

Bold

нет данных

Курсив

Italic

нет данных

Забастовка

Strike

нет данных

Подчеркивание

Underline

нет данных

Доступ к строке таблицы или записи

Чтобы получить доступ к строке в таблице, используйте mlreportgen.ppt.Table.row метод. Задайте Table возразите и количество строки, к которой вы хотите получить доступ. Например, чтобы получить доступ к TableRow объект для второй строки myTableИспользование:

myTable = Table(magic(5));
row2 = row(myTable,2);

Чтобы получить доступ к записи в таблице, используйте mlreportgen.ppt.Table.entry метод. Задайте Table возразите и количество строки и количество столбца, к которому вы хотите получить доступ. Например, чтобы получить доступ к TableEntry объект для третьей записи во второй строке myTableИспользование:

myTable = Table(magic(5));
entry3row2 = entry(myTable,2,3);

В качестве альтернативы можно получить доступ к строке таблицы при помощи Children свойство Table объект. Можно получить доступ к записи таблицы при помощи Children свойство TableRow объект. Например, чтобы получить доступ к третьей записи во второй строке myTable:

myTable = Table(magic(5));
entry3row2 = myTable.Children(2).Children(3);

Отформатируйте столбец

Чтобы отформатировать столбец в таблице, используйте один или несколько mlreportgen.ppt.ColSpec объекты. Создайте ColSpec объект для каждого столбца, что вы хотите отформатировать и задать форматирование для каждого ColSpec объект. Затем задайте массив ColSpec объекты и использование это с ColSpecs свойство Table объект.

Спецификация формата для строки таблицы более приоритетна по сравнению со спецификацией формата для столбца.

import mlreportgen.ppt.*
slidesFile = 'myColSpecs.pptx'
slides = Presentation(slidesFile);
add(slides,'Title and Content');

t = Table(magic(12));
t.Style = {HAlign('center')};

colSpecs(2) = ColSpec('1.5in');
colSpecs(1) = ColSpec('1.5in');
colSpecs(1).BackgroundColor = 'red';
colSpecs(2).BackgroundColor = 'green';
t.ColSpecs = colSpecs;
t.row(2).Style = {VAlign('bottom')};
t.row(2).BackgroundColor = 'tan';
t.entry(2,3).FontColor = 'red';
t.entry(2,3).FontSize = '30pt';

replace(slides,'Content',t);

close(slides);
if ispc
winopen(slides.OutputPath);
end

Когда вы создаете ColSpec объект, можно задать ширину столбца в конструкторе. Например:

myColSpec = ColSpec('3in');
Кроме того, можно задать ширину столбца с помощью свойства Width ColSpec объект. Вы задаете другие свойства форматирования ColSpec объект, такой как BackgroundColor.

Просмотрите имена стиля таблицы

Если вы используете API PPT, чтобы задать стиль таблицы кроме значения по умолчанию, необходимо знать имена стилей таблицы в шаблоне PowerPoint. Можно просмотреть имя в PowerPoint или использовании API PPT.

  1. В PowerPoint выберите View> Slide Master.

  2. В размещении понижения, которое имеет таблицу, нажмите Table (или где угодно в том заполнителе). На вкладке Insert нажмите Table.

  3. Составьте пустую таблицу в размещении понижения.

    Панель Table Styles появляется. Чтобы видеть имя стиля таблицы, наведите на изображение стиля таблицы.

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

import mlreportgen.ppt.*
slides = Presentation('myPlaceholderPresentation');

getTableStyleNames(slides)
ans = 

'Medium Style 2 - Accent 1'     '{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}'
'Light Style 1'                 '{9D7B26C5-4107-4FEC-AEDC-1716B250A1EF}'

Чтобы использовать имя стиля таблицы с API PPT, можно использовать или имя или числовой идентификатор.

Смотрите также

Функции

Классы

Связанные примеры

Больше о

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