Документация

Функции инструмента миграции

Инструмент миграции помогает вам преобразовать приложения путем чтения в файле GUIDE FIG и автоматической генерации эквивалентных компонентов и размещения App Designer в файле MLAPP. Код коллбэка GUIDE и другие пользовательские функции копируются в файл MLAPP. Это полуавтоматическое преобразование кода также создает отчет о миграции, который предлагает действия для любых ручных обновлений кода, которые необходимы. Некоторые функции инструмента описаны в этой таблице.

Код коллбэка

В порядок, чтобы сделать ваш коллбэк код в стиле GUIDE совместимым с компонентами пользовательского интерфейса App Designer в вашем приложении, инструмент миграции использует функцию, называемую convertToGUIDECallbackArguments. Эта функция преобразует аргументы коллбэка App Designer в аргументы коллбэка в стиле GUIDE, которые требуются вашему коду. The convertToGUIDECallbackArguments функция добавляется к началу каждой перенесенной функции обратного вызова. Для этого требуются аргументы коллбэка App Designer app и event и возвращает аргументы коллбэка в стиле GUIDE hObject, eventdata, и handles. Для примера:

hObject - указатель на объект, коллбэк выполняет. Для компонентов из вашего приложения GUIDE, которые были UIControl или ButtonGroup объекты, hObject является указателем на UIControlPropertiesConverter или ButtonGroupPropertiesConverter объект. Эти объекты создаются, чтобы код в стиле GUIDE работал в функциях обратного вызова App Designer.

eventdata обычно пуст, но может быть структурой, содержащей определенную информацию о событии коллбэка.

handles - структура, содержащая перенесенные дочерние компоненты фигуры пользовательского интерфейса, которые имеют 'Tag' набор значений свойств. Дочерние компоненты, которые были UIControl объекты в вашем приложении GUIDE UIControlPropertiesConverter объекты в перенесенном приложении. Аналогично, дочерние ButtonGroup объекты ButtonGroupPropertiesConverter объекты в перенесенном приложении.

The UIControlPropertiesConverter и ButtonGroupPropertiesConverter объекты действуют как адаптеры между кодом в стиле GUIDE и компонентами App Designer и коллбэками. A UIControlPropertiesConverter создается для каждого компонента приложения GUIDE, который был UIControl объект. Эти объекты конвертера связаны с компонентом пользовательского интерфейса App Designer в перенесенном приложении. Объект конвертера имеет те же свойства и значения, что и исходный UIControl из вашего приложения GUIDE, но оно применяет их к связанному с ним компоненту Designer.

Точно так же для ButtonGroup объекты из GUIDE, a ButtonGroupPropertiesConverter создается в App Designer. Этот объект позволяет задать SelectedObject свойство для UIControlPropertiesConverter объект, так что группа кнопок SelectionChangedFcn будет функционировать логика коллбэка.

Особые факторы

Существуют некоторые обстоятельства, которые требуют, чтобы вы сделали дополнительные шаги до или после миграции вашего приложения. в этой таблице перечислены общие сценарии и шаблоны кодирования, которые требуют дополнительных шагов или ручных обновлений кода. Этот список не должен быть исчерпывающим.

function out = MyGUIDEApp(varargin)
    app = MyMigratedApp(varargin{:});
    out = app.UIFigure;            
end

Если ваше приложение GUIDE интегрирует сторонние компоненты с помощью таких функций, как actxcontrol, см. Рекомендации для приложений MATLAB, использующих Java и ActiveX.

Средства для добавления новых возможностей или полного принятия стиля кода App Designer

App Designer и GUIDE имеют различные структуры кода, синтаксис коллбэка и методы для доступа к компонентам пользовательского интерфейса и обмена данными. Понимание этих различий полезно, если вы планируете добавить новые функции App Designer в перенесенное приложение или хотите обновить его, чтобы использовать стиль кода и соглашения App Designer. В этой таблице обобщены некоторые из этих различий.