RMI включает несколько функций, которые упрощают создание навигационных интерфейсов во внешних документах. Внешнее приложение, отображающее документ, должно поддерживать интерфейс прикладного программирования (API) для связи с MATLAB® программное обеспечение.
Каждый раз, когда вы создаете ссылку требования для Simulink® или Stateflow® объект, RMI использует глобально уникальный идентификатор для этого объекта. Этот идентификатор идентифицировал объект. Идентификатор не меняется, если вы переименовываете или перемещаете объект, или добавляете или удаляете ссылки требования. RMI использует уникальный идентификатор только для разрешения объекта в модели.
rmiobjnavigate
ФункцияThe 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. Существует два свойства образца, которые определяют, как работает элемент управления. The tooltipstring
свойство отображается в всплывающей подсказке управления. The 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