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

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

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

Код коллбэка

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

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

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

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

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

Точно так же для ButtonGroup объекты от GUIDE, 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 и соглашения. Эта таблица суммирует некоторые из этих различий.