GUIDE 迁移策略

迁移工具的功能

该迁移工具可读入 GUIDE FIG 文件并在 MLAPP 文件中自动生成 App 设计工具等效组件和布局，以此帮助您转换 App。您的 GUIDE 回调代码和用户定义的其他函数将被复制到 MLAPP 文件中。这种半自动代码转换还会创建迁移报告，该报告为需要手动进行代码更新的部分提供操作建议。下表描述了该工具的一些功能。

回调代码

为了在您的 App 中使 GUIDE 样式回调代码与 App 设计工具 UI 组件兼容，迁移工具使用名为 convertToGUIDECallbackArguments 的函数。此函数将 App 设计工具回调参量转换为您的代码所需的 GUIDE 样式回调参量。convertToGUIDECallbackArguments 函数将添加到每个迁移的回调函数的开头。它接受 App 设计工具回调参量 app 和 event，并返回 GUIDE 样式回调参量 hObject、eventdata 和 handles。例如：

每个 GUIDE 样式回调参量都有不同用途：

UIControlPropertiesConverter 和 ButtonGroupPropertiesConverter 对象就像 GUIDE 样式代码和 App 设计工具组件及回调之间的适配器。为使用 GUIDE 创建的 App 中作为 UIControl 对象的每个组件创建一个 UIControlPropertiesConverter 对象。这些转换器对象与迁移的 App 中的 App 设计工具 UI 组件相关联。转换器对象与使用 GUIDE 创建的 App 中的原始 UIControl 具有相同的属性和值，但转换器对象将它们应用于其关联的 App 设计工具 UI 组件。

同样，对于 GUIDE 中的 ButtonGroup 对象，在 App 设计工具中会创建 ButtonGroupPropertiesConverter 对象。通过此对象，可以将 SelectedObject 属性设置为 UIControlPropertiesConverter 对象，以便按钮组 SelectionChangedFcn 回调逻辑正常工作。

特殊注意事项

有些情况需要您在迁移 App 之前或之后采取额外的步骤。下表列出了需要额外步骤或手动代码更新的常见场景和编码模式。此列表并未列出所有情形。

function figure1WindowButtonDown(app,event)
    if app.figure1.CurrentObject == app.listbox1
        % Execute callback code
    end
end

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

如果您使用 GUIDE 创建的 App 使用 actxcontrol 等函数集成第三方组件，请参阅关于使用 Java 和 ActiveX 的 MATLAB App 的建议。

GUIDE 和 App 设计工具代码之间的差异

App 设计工具与 GUIDE 之间的主要差异在于代码结构、回调语法以及访问 UI 组件和共享数据的方式。如果您计划向迁移的 App 添加新 App 设计工具功能，或希望更新该 App 以使用 App 设计工具代码样式和约定，了解这些差异将非常有用。下表总结了其中一些差异。

更新迁移的 App 回调代码

迁移的 App 使用 GUIDE 样式对象和代码约定。最好在迁移的 App 中更新回调代码以使用 App 设计工具对象和代码约定。更新您的回调代码可支持现代 App 构建功能，并使 App 更易于维护。要更新您的代码，请按照以下步骤操作：

如果您的 App 使用了 errordlg 或 warndlg 等函数创建对话框，您也可以更新代码，比如使用 uialert 和 uiconfirm 函数，创建专门用于 App 构建的现代对话框。有关详细信息，请参阅Update Dialog Boxes。

识别组件标记

要对 App 中某个组件的外观或回调进行更改，需要首先识别组件的 Tag 属性的值。GUIDE 生成的代码使用此属性的值来访问该组件。例如，如果您有一个按钮，其 Tag 值为 pushbutton1，则该组件的回调函数的名称为 pushbutton1_callback，您可以通过访问 handles.pushbutton1 来修改该对象。

要查找特定组件的 Tag 值，请先使用一个输出参量运行您的 App 以返回 App 的 Figure 对象。然后，使用以下策略之一访问该组件：

最后，当您能够访问该组件对象后，请使用圆点表示法查询其 Tag 属性。

tag = h.Tag

编辑 App 行为

使用 GUIDE 创建的 App 中的组件在代码文件中具有关联的回调函数。这些函数控制 App 在用户与其交互时的行为。您可以继续编辑这些回调函数以维护您的 App。

例如，以下函数定义是 GUIDE 为一个带有 pushbutton1 的普通按钮生成的回调函数示例。您可以向此函数添加代码，该代码在用户按下按钮时执行。

function pushbutton1_Callback(hObject,eventdata,handles)
% hObject    handle to pushbutton1 (see GCBO)
% eventdata  reserved - to be defined in a future version of MATLAB
% handles    structure with handles and user data (see GUIDATA)

end

@(hObject,eventdata)myui('pushbutton1_Callback',hObject,eventdata,guidata(hObject))

eventdata 参量为某些回调函数提供详细信息。例如，如果 App 用户触发 KeyPressFcn 回调，则 MATLAB 提供有关 App 用户按下的特定键（或组合键）的信息。如果 eventdata 不可用于回调函数，则 MATLAB 会将其作为空数组传递。下表列出了使用 eventdata 的回调和组件。

编辑 App 布局

使用 GUIDE 创建的每个 App 在代码文件中都有一个名为 appname_OpeningFcn 的函数。此函数在 App 运行时执行。要编辑 App 的布局，请向此函数添加代码。

例如，假设您的 App 有标记为 pushbutton1 的普通按钮。要更改该按钮上的文本并更新按钮宽度，请将以下代码添加到代码文件中的 OpeningFcn 回调。

btn = handles.pushbutton1;
btn.String = "Push me";
btn.Position(3) = 30;

您还可以在 App 中添加和删除组件。每当您添加或删除组件时，都需要更新 handles 结构体。然后，在回调函数的末尾，添加以下代码以使用 guidata 函数保存结构体。

guidata(hObject,handles)

例如，要删除普通按钮，请将以下代码添加到 OpeningFcn 回调。

delete(handles.pushbutton1)
handles = rmfield(handles,"pushbutton1");
guidata(hObject,handles);

要向 App 添加复选框，请将以下代码添加到 OpeningFcn 回调。

cbx = uicontrol(handles.figure1, ...
    Style="checkbox",Position=[20 10 80 20],Tag="checkbox1");
handles.checkbox1 = cbx;
guidata(hObject,handles);

要添加具有回调的组件，您必须在文件中添加一些额外的代码以将该行为合并到 App 中。例如，要添加一个在其值更改时显示某些文本的复选框，请首先将以下代码添加到 OpeningFcn 回调，以将 myui 替换为您的 App 文件的名称。这些代码会创建复选框，为其分配唯一标记，并指定名为 checkbox1_Callback 的回调函数。

cbx = uicontrol(handles.figure1, ...
    Style="checkbox",Position=[20 10 20 20],Tag="checkbox1", ...
    Callback=@(hObject,eventdata)myui("checkbox1_Callback",hObject,eventdata,guidata(hObject)));
handles.checkbox1 = cbx;
guidata(hObject,handles);

然后，将回调函数添加到代码文件中。指定 MATLAB 传递给使用 GUIDE 创建的 App 中的回调的三个输入参量。

% --- Executes on value changed in checkbox1.
function checkbox1_Callback(hObject,eventdata,handles)
% hObject    handle to checkbox1 (see GCBO)
% eventdata  reserved - to be defined in a future version of MATLAB
% handles    structure with handles and user data (see GUIDATA)
disp("Value changed")
end