Переход к объектам Simulink из внешних документов

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 для визуальной идентификации целевого объекта в документе требований.

Используйте элемент управления навигацией ActiveX

RMI использует программное обеспечение, которое включает в себя специальный Microsoft® ActiveX® управление для включения навигации по объектам Simulink из Microsoft Word и Excel® документы. Этот же элемент управления можно использовать в любом другом приложении, поддерживающем ActiveX в его документах.

Элемент управления выводится из кнопки и имеет значок Simulink. Существует два свойства образца, которые определяют, как работает элемент управления. The tooltipstring свойство отображается в всплывающей подсказке управления. The MLEvalCmd свойство является вектором символов, которую вы передаете в программное обеспечение MATLAB для оценки при клике по элементу управления.

Типичная последовательность кодов для установления навигационных органов управления

При создании интерфейса к внешнему инструменту можно автоматизировать процедуру установления ссылок. Таким образом, вы не должны вручную обновлять поля диалогового окна. Этот тип автоматизации происходит как часть основанной на выборе ссылки для некоторых встроенных типов, таких как документы Microsoft Word и Excel.

Для автоматизации процедуры установления ссылок:

  1. Выберите объект Simulink или Stateflow и элемент во внешнем документе.

  2. Активируйте действие создания ссылки из меню или команды Simulink или аналогичного механизма во внешнем приложении.

  3. Идентифицируйте документ и текущий элемент с помощью возможности создания сценариев внешнего инструмента. Передайте эту информацию в программное обеспечение MATLAB. Создайте ссылку требования к выбранному объекту с помощью RMI API следующим образом:

    1. Создайте пустую структуру ссылки с помощью следующей команды:

      rmi('createempty')
    2. Заполните поля структуры ссылки на основе целевого местоположения в документе потребности.

    3. Прикрепить ссылку к объекту можно используя следующую команду:

      rmi('cat')
  4. Определите навигационную команду MATLAB, которую вы должны встраивать во внешний инструмент, используя navCmd метод:

    [ navCmd, objPath ] = rmi('navCmd',obj)

  5. Создайте элемент навигации во внешнем документе с помощью возможности создания сценариев внешнего инструмента. Установите навигационную команду 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