RMI включает несколько функций, упрощающих создание навигационных интерфейсов во внешних документах. Внешнее приложение, отображающее документ, должно поддерживать интерфейс прикладного программирования (API) для связи с программным обеспечением MATLAB ® .
Каждый раз, когда создается ссылка требования для объекта Simulink ® или Stateflow ®, RMI использует глобальный уникальный идентификатор для этого объекта. Этот идентификатор идентифицировал объект. Идентификатор не изменяется при переименовании или перемещении объекта, а также при добавлении или удалении связей требований. RMI использует уникальный идентификатор только для разрешения объекта в модели.
rmiobjnavigate Функция rmiobjnavigate функция определяет объект Simulink или Stateflow, подсвечивает этот объект и выводит окно редактора на передний план экрана. При переходе к модели Simulink из внешнего приложения вызовите эту функцию.
При первом переходе к элементу в определенной модели может возникнуть небольшая задержка, когда программное обеспечение инициализирует коммуникационный API и внутренние структуры данных. При последующей навигации не возникает длительной задержки.
Чтобы создать ссылку требования для объекта Simulink или Stateflow, по запросу MATLAB используйте следующую команду для поиска команды навигации, где obj является дескриптором или уникально разрешенным именем для объекта:
[ navCmd, objPath ] = rmi('navCmd', obj);Возвращаемые значения navCmd способ:
navCmd - символьный вектор, который переходит к объекту при вычислении программным обеспечением MATLAB.
objPath - символьный вектор, определяющий объект модели.
Послать navCmd в программное обеспечение MATLAB для анализа при переходе от внешнего приложения к объекту obj в модели Simulink. Использовать objPath визуальная идентификация целевого объекта в документе потребности.
В RMI используется программное обеспечение, включающее специальный элемент управления Microsoft ® ActiveX ®, позволяющий переходить к объектам Simulink из документов Microsoft Word и Excel ®. Этот же элемент управления можно использовать в любом другом приложении, поддерживающем ActiveX в документах.
Элемент управления является производным от кнопки и имеет значок Simulink. Существует два свойства экземпляра, которые определяют работу элемента управления. tooltipstring отображается в подсказке элемента управления. MLEvalCmd свойство - это вектор символов, передаваемый в программу MATLAB для вычисления при щелчке на элементе управления.
При создании интерфейса с внешним инструментом можно автоматизировать процедуру установления связей. Таким образом, обновление полей диалогового окна вручную не требуется. Этот тип автоматизации выполняется как часть привязки на основе выбора для определенных встроенных типов, таких как документы Microsoft Word и Excel.
Для автоматизации процедуры установления связей:
Выберите объект Simulink или Stateflow и элемент во внешнем документе.
Вызовите действие создания связи из меню или команды Simulink или аналогичного механизма во внешнем приложении.
Определение документа и текущего элемента с помощью возможностей сценария внешнего инструмента. Передайте эту информацию в программное обеспечение MATLAB. Создайте ссылку требования для выбранного объекта с помощью RMI API следующим образом:
Создайте пустую структуру связи с помощью следующей команды:
rmi('createempty')Заполните поля структуры связи на основе целевого местоположения в документе потребности.
Присоедините ссылку к объекту с помощью следующей команды:
rmi('cat')Определите команду навигации MATLAB, которую необходимо встроить во внешний инструмент, используя navCmd способ:
[ navCmd, objPath ] = rmi('navCmd',obj)Создайте элемент навигации во внешнем документе, используя возможность создания сценариев внешнего инструмента. Задайте команду навигации MATLAB в свойстве.
При использовании объектов навигации ActiveX, предоставляемых внешним инструментом, установите MLEvalCmd к свойству navCmd и установите tooltipstring свойство для objPath.
Реализация кода MATLAB этой процедуры определяется как SelectionLinkFcn в файле определения типа связи. Следующие файлы в matlabroot\toolbox\slrequirements\linktype_examples содержат примеры того, как реализовать эту функциональность:
linktype_rmi_doors.m linktype_rmi_excel.m linktype_rmi_html.m linktype_rmi_text.m