Документация

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

PowerPoint^® шаблон должен содержать образец стиля таблицы, чтобы использовать его в программе PPT API. Чтобы перечислить образцы стилей таблиц в шаблоне, используйте 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);

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

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}'

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

Форматирование таблицы с использованием стиля таблицы

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

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 объект.

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

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

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

Для доступа к строке в таблице используйте 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');