Задайте задачи для компонента, чтобы выполнить

Об индивидуальной настройке компонента

Создание компонента создает MATLAB® файлы в рабочем пространстве MATLAB. Задайте задачи, которые вы хотите, чтобы ваш компонент выполнил путем редактирования этих файлов MATLAB.

Примечание

Необходимо задать формат и содержимое отчета, выведенного путем редактирования execute.m. Этот файл называется во время генерации отчета, чтобы вызвать задачи вашего компонента. Опционально, можно задать дополнительные свойства компонентов и поведение путем редактирования других файлов MATLAB.

Для получения дополнительной информации смотрите следующие разделы:

Требуемая настройка: задайте формат и содержимое отчета Выход

После того, как вы создаете компонент, задаете формат и содержимое вашего отчета, выведенного путем редактирования execute.m файл.

execute команда имеет следующий синтаксис:

out = execute(thisComp, parentDoc)

Где:

  • thisComp указатель на компонент, который вы запускаете.

  • parentDoc указатель на документ, который вы генерируете.

  • out узел Объектной модели документа (DOM) или строка, чтобы добавить к отчету.

    Для получения информации об управлении узлами DOM смотрите xmlwrite в документации MATLAB.

Одна или несколько строк кода по умолчанию в execute.m файл показывает каждое свойство для компонента. Вот пример линии свойства компонентов в execute.m файл:

pstring = thisComp.NewStringProperty;  % New string property;

Следующие разделы описывают, как отредактировать execute.m создать дополнительные элементы отчета.

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

Чтобы составить таблицу, замените Source значение свойства с именем массива ячеек или структуры:

out = execute(rptgen.cfr_table(...
'Source', tableSrc,...
'numHeaderRows',1,...
'TableTitle','Example Title'),...
 parentDoc);

Для получения дополнительной информации введите help(rptgen.cfr_table) в командной строке MATLAB.

Создайте списки

Чтобы создать список, замените Source значение свойства с именем вектора ячейки:

out = execute(rptgen.cfr_list(...
'Source', listSrc,...
'ListStyle','orderedlist',...
'ListTitle','Example List'),...
 parentDoc);

Для получения дополнительной информации введите help(rptgen.cfr_list) в командной строке MATLAB.

Создайте текст

Чтобы создать текст, замените ParaText значение свойства с вектором символов:

out = execute(rptgen.cfr_paragraph(...
'ParaText', paraSrc,...
 parentDoc);

Для получения дополнительной информации введите help(rptgen.cfr_paragraph) в командной строке.

Создайте фигуры

Чтобы создать фигуры, задайте фигуру в FigureHandle значение свойства.

figSrc = gcf;
out = execute(rptgen_hg.chg_fig_snap(...
'FigureHandle', figSrc,...
'Title', '',...
'isResizeFigure', 'manual',...
'PrintSize', [6 4],...
'PrintUnits', 'inches'),...
 parentDoc);

Для получения дополнительной информации введите help(rptgen_hg.chg_fig_snap) в командной строке MATLAB.

Запустите дочерние компоненты

Следующий код запускает дочерние компоненты. Первая линия вызывает execute.m для дочерних компонентов. Вторая линия добавляет результаты выполнения дочерних компонентов к отчету:

childOut = thisComp.runChildren(parentDoc);
out = parentDoc.createDocumentFragment(out, childOut);

Измените текст структуры компонента в иерархии Report Explorer

Поменять струну раньше описывало компонент в иерархии Report Explorer, редактировало getOutlineString Файл MATLAB. По умолчанию, getoutlinestring возвращает имя отображения компонента. getOutlineString команда имеет следующий синтаксис:

olstring = getOutlineString(thisComp) 

Где:

  • thisComp компонент, описание которого вы задаете.

  • olstring одна линия, которая отображает информацию о компоненте. Это может содержать максимум 32 символов.

Настройте строку, чтобы включать дополнительную информацию о компоненте, таком как информация о ее свойствах. В следующем примере, truncatestring функция преобразует входные данные в однострочный вектор символов. Если данные пусты, второй аргумент является возвращаемым значением, третий аргумент является максимальным позволенным размером получившегося вектора символов.

cInfo = '';
pstring = rptgen.truncateString(thisComp.string,'<empty>',16);

Используйте тире (-) как диафрагма между именем и дополнительной информацией компонента, можно следующим образом:

if ~isempty(cInfo)
   olstring = [olstring, '-', cInfo];
end

Измените внешний вид диалоговых окон свойств

Можно отредактировать getdialogschema.m файл, чтобы управлять большинством аспектов размещения диалогового окна, включая:

  • Создание и размещение виджетов

  • Организация виджетов в панели

  • Создание отображения верхнего уровня, в котором находятся панели

Синтаксис команды:

dlgstruct = getdialogschema(thisComp, name)

Где:

  • thisComp экземпляр отредактированного компонента.

  • name вектор символов, который передается getdialogschema создавать определенный тип панели. Обычно, name пусто в Report Explorer.

Примечание

Не изменяйте поля, которые явным образом не включены в этот файл. Эти поля подвержены изменениям в будущих релизах.

Задайте дополнительные свойства компонентов

Можно отредактировать дополнительные файлы MATLAB, чтобы настроить компонент далее. Чтобы получить доступ к этим файлам, щелкните правой кнопкой по компоненту по панели Схемы слева в Report Explorer и выберите Edit files из его контекстного меню.

Для получения дополнительной информации смотрите следующие разделы:

Задайте, могут ли компоненты иметь дочерние компоненты

Чтобы задать, может ли компонент иметь дочерние элементы, отредактируйте getParentable.m. Эта команда возвращает значение true или false. Например, если вы больше не хотите, чтобы ваш компонент имел дочерние компоненты, измените значение в рамках кода можно следующим образом:

p = false;

Измените описание компонента

Описание в getDescription.m то же значение как поле Description в Report Explorer. Следующий пример показывает, как отредактировать compDesc значение в этом файле, чтобы изменить описание компонента в An example component:

compDesc = 'An example component';

Поменяйте имя отображения компонента

Имя отображения в getName.m то же значение как поле Display name в Report Explorer. Следующий пример показывает, как отредактировать compName значение в этом файле, чтобы изменить название отображения компонента на Example Component:

compName = 'Example Component';

Измените название категории компонента

Название категории в getType.m то же значение как поле Category name в Report Explorer. Следующий пример показывает, как отредактировать compCategory значение в этом файле, чтобы изменить название категории компонента в Custom Components:

compCategory = 'Custom Components';

Укажите компоненты

Можно указать компоненты в Report Explorer с помощью rptcomps2.xml. Этот файл также помогает создать список доступных компонентов.

Содержимое этого файла должно быть сопоставимо со значениями в getName.m и getType.m файлы. Если вы изменили значения в любом из этих файлов, необходимо также изменить их значения в rptcomps2.xml. Необходимо перезапустить сеанс программного обеспечения MATLAB для Report Explorer, чтобы отобразить новую информацию.

Отобразите справку компонента в браузере документации MATLAB

viewHelp.m файл отображает справочный файл для компонента в Браузере документации MATLAB. Чтобы отобразить справочный файл, подсветите имя компонента в Report Explorer и нажмите Help.

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