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

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

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

Код обратного вызова

Чтобы сделать код обратного вызова в стиле GUIDE совместимым с компонентами пользовательского интерфейса App Designer в приложении, средство миграции использует функцию convertToGUIDECallbackArguments. Эта функция преобразует аргументы обратного вызова App Designer в аргументы обратного вызова в стиле GUIDE, требуемые кодом. 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 объектов в перенесенном приложении.

UIControlPropertiesConverter и ButtonGroupPropertiesConverter объекты действуют как адаптеры между кодом в стиле GUIDE и компонентами App Designer и обратными вызовами. A UIControlPropertiesConverter создается для каждого компонента в приложении GUIDE, который был UIControl объект. Эти объекты конвертера связаны с компонентом пользовательского интерфейса App Designer в переносимом приложении. Объект конвертера имеет те же свойства и значения, что и исходный UIControl из вашего приложения GUIDE, но оно применяет их к связанному с ним компоненту пользовательского интерфейса App 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. В этой таблице обобщены некоторые из этих различий.