Создание компонента создает файлы 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, редактировало 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, чтобы отобразить новую информацию.
viewHelp.m
файл отображает справочный файл для компонента в Браузере документации MATLAB. Чтобы отобразить справочный файл, подсветите имя компонента в Report Explorer и нажмите Help.