在 App 设计工具的代码视图中管理代码

代码视图提供了 MATLAB^® 编辑器中的大多数编程功能。它还提供了丰富的功能，可帮助您浏览代码，避免许多繁琐的任务。例如，您可以通过在搜索栏中键入部分名称来搜索回调。点击某个搜索结果，编辑器将滚动到该回调的定义。此外，如果您更改了某个回调的名称，App 设计工具会自动更新代码中对该回调的所有引用。

管理组件、函数和属性

代码视图有三个窗格可帮助您管理代码的不同方面。下表介绍了每一个窗格。

窗格名称	窗格外观	窗格功能
组件浏览器		上下文菜单 - 右键点击列表中的组件以显示上下文菜单，该菜单包含用于删除或重命名组件、添加回调或显示帮助的选项。选择在组件浏览器中包括组件标签选项，将显示分组的组件标签。搜索栏 - 通过在搜索栏中键入部分名称，即可快速定位组件。组件选项卡 - 使用此选项卡查看或更改当前所选组件的属性值。还可以通过在此选项卡顶部的搜索栏中键入部分名称来搜索属性。回调选项卡 - 使用此选项卡管理所选组件的回调。
代码浏览器		回调、函数和属性选项卡 - 使用这些选项卡添加、删除或重命名 App 中的任何回调、辅助函数或自定义属性。点击回调或函数选项卡上的某个项目，编辑器将滚动到代码中的对应部分。通过选择要移动的回调，然后将回调拖放到列表中的新位置，来重新排列回调的顺序。此操作会同时在编辑器中调整回调位置。搜索栏 - 通过在搜索栏中键入部分名称，即可快速定位回调、辅助函数或属性。
App 布局		App 缩略图 - 使用缩略图可在具有许多组件的复杂大型 App 中查找组件。在缩略图中选择某个组件，即会在组件浏览器中选择该组件。

窗格名称

窗格外观

窗格功能

组件浏览器

Component Browser showing the property inspector for a button component.

上下文菜单 - 右键点击列表中的组件以显示上下文菜单，该菜单包含用于删除或重命名组件、添加回调或显示帮助的选项。选择在组件浏览器中包括组件标签选项，将显示分组的组件标签。
搜索栏 - 通过在搜索栏中键入部分名称，即可快速定位组件。
组件选项卡 - 使用此选项卡查看或更改当前所选组件的属性值。还可以通过在此选项卡顶部的搜索栏中键入部分名称来搜索属性。
回调选项卡 - 使用此选项卡管理所选组件的回调。

代码浏览器

Code Browser showing the Callbacks tab with three callbacks.

回调、函数和属性选项卡 - 使用这些选项卡添加、删除或重命名 App 中的任何回调、辅助函数或自定义属性。点击回调或函数选项卡上的某个项目，编辑器将滚动到代码中的对应部分。通过选择要移动的回调，然后将回调拖放到列表中的新位置，来重新排列回调的顺序。此操作会同时在编辑器中调整回调位置。
搜索栏 - 通过在搜索栏中键入部分名称，即可快速定位回调、辅助函数或属性。

App 布局

App Layout showing a thumbnail of an app that contains a radio button group, a slider and a push button.

App 缩略图 - 使用缩略图可在具有许多组件的复杂大型 App 中查找组件。在缩略图中选择某个组件，即会在组件浏览器中选择该组件。

识别代码中的可编辑部分

在代码视图编辑器中，代码中的有些部分是可编辑的，有些则不可编辑。不可编辑部分由 App 设计工具生成和管理，可编辑部分包括：

您定义的函数（例如，回调和辅助函数）的主体
自定义属性定义

在默认颜色方案中，代码的不可编辑部分以灰色显示，可编辑部分以白色显示。

App code. A properties block and body of a function have a white background, while a methods block and function declaration have a gray background.

编写 App

App 设计工具将您的 App 定义为 MATLAB 类。要创建 App，您并不需要了解类或面向对象的编程，因为 App 设计工具会管理代码的这些方面。但是，App 设计工具中的编程所需要的工作流不同于严格使用函数的工作流。您可以在工具条的资源选项卡上点击显示提示 按钮，随时查看此工作流的总结。

管理 UI 组件

在您的 App 中添加 UI 组件时，App 设计工具会为组件指定一个默认的名称。使用此名称（包括 app 前缀）可在您的代码中引用该组件。您可以通过双击组件浏览器中的名称并键入新名称来更改组件的名称。当您更改组件名称时，App 设计工具会自动更新对该组件的所有引用。

Component Browser showing the name of a figure and a button component. The name of the button is app.Button, and the text "Button" is highlighted and editable.

要在您的代码中使用组件的名称，较省时间的方法是从组件浏览器中复制名称。将光标放在代码的可编辑区域中要添加组件名称的位置。然后，在组件浏览器中，右键点击组件名称并选择在光标处插入。您也可以将组件名称从列表拖到代码中。

Context menu associated with the app.Button component. The context menu includes the Insert at Cursor option.

要删除组件，请在组件浏览器中选择其名称，然后按 Delete 键。

管理回调

要使组件响应用户交互，可以添加回调。右键点击组件浏览器中的组件，然后选择回调 > 添加 (回调属性) 回调。

如果您从 App 中删除组件，仅当关联的回调未被编辑且未与其他组件共享时，App 设计工具才会删除关联的回调。

要手动删除回调，请在代码浏览器的回调选项卡上选择回调名称，然后按 Delete 键。

有关回调的详细信息，请参阅App 设计工具中的回调。

在 App 中共享数据

要存储数据并在不同的回调之间共享这些数据，请创建一个属性。例如，如果希望 App 读取数据文件并允许 App 中的不同回调访问该数据，请在加载文件时将数据存储在一个属性中。

要创建属性，请在编辑器选项卡上展开属性下拉列表，然后选择私有属性或公共属性。App 设计工具将创建一个模板属性定义，并将光标放在该定义旁边。根据需要更改属性的名称。

properties (Access = public)
        X % Average cost
end

要在代码中引用该属性，请使用语法 app.PropertyName。例如，app.X 引用名为 X 的属性。

有关创建和使用属性的详细信息，请参阅在用 App 设计工具创建的 App 内共享数据。

在多个位置运行的单一源代码

如果要在 App 中的多个位置执行同一个代码块，可以创建辅助函数。例如，您可能想创建一个辅助函数以在用户更改编辑字段中的数字或选择下拉列表中的项后更新绘图。通过创建辅助函数，您可以使常用命令执行同一个来源的代码，而不用维护几组多余的代码。

要添加辅助函数，请在编辑器选项卡上展开函数下拉列表，然后选择私有函数或公共函数。App 设计工具将创建一个模板函数，并将光标放在该函数的主体中。

要删除辅助函数，请在代码浏览器的函数选项卡上选择函数名称，然后按 Delete 键。

有关编写辅助函数的详细信息，请参阅使用辅助函数重用代码。

创建输入参量

要在 App 中添加输入参量，请在编辑器选项卡上点击 App 输入参量 。输入参量通常用于创建具有多个窗口的 App。有关详细信息，请参阅App 设计工具中的启动任务和输入参量。

为您的 App 添加帮助文本

添加 App 摘要和描述，以向用户提供有关您的 App 的信息。要添加帮助文本或编辑现有帮助文本，请点击 App 帮助文本 。使用“App 帮助文本”对话框可以指定 App 的简短摘要，以及对该 App 的功能和使用方法的更详细解释。App 设计工具可将此帮助文本以注释形式添加到 App 定义语句中。

要在 MATLAB 命令行窗口中显示 App 帮助文本，请调用 help 函数并指定 App 名称。App 帮助文本会出现在 App 文档页的顶部。您可以通过调用 doc 函数并指定 App 名称来查看 App 的文档页。

限制您的 App 一次只运行一个实例

在 App 设计工具中创建 App 时，您可以在 App 的两种运行行为之间进行选择：

一次只允许运行一个 App 实例。
允许同时运行 App 的多个实例。这是默认行为。

要更改 App 的运行行为，请从组件浏览器中选择 App 节点。然后，从 App 选项卡的代码选项部分，选中或清除单个运行实例。

Component Browser Inspector for the app node. The Code Options section is expanded and shows the Single Running Instance check box.

当选中单个运行实例并且您多次运行该 App 时，MATLAB 会重用现有实例并将其前置，而不是创建一个新实例。如果清除此选项，则 MATLAB 会在每次运行该 App 时都创建一个新实例，并继续运行现有实例。这些运行行为适用于您从 MATLAB 工具条上的 App 选项卡或从命令行窗口运行的 App。

当您从 App 设计工具运行 App 时，无论此选项处于选中还是清除状态，其行为都不会更改。App 设计工具在创建新的 App 实例之前始终会先关闭该 App 的现有实例。

修复代码问题和运行时错误

与 MATLAB 编辑器一样，代码视图编辑器也提供代码分析器消息，帮助您发现代码中的错误。

Code Analyzer message for an edit field callback. The code in the function body sets EditField.Value. The message says "Use app.EditField to reference a property of app" and includes a button labeled "Fix".

如果直接从 App 设计工具中运行您的 App（通过点击运行），倘若在运行时发生任何错误，App 设计工具会在您的代码中突出显示错误的来源。要隐藏错误消息，请点击错误指示符（红色圆圈）。要使错误指示符消失，请更正代码并保存更改。

Error message. The line of code with the error has an error indicator next to it.

您还可以通过在 App 设计工具中以交互方式调试 App 代码来诊断代码中的问题。有关详细信息，请参阅调试 MATLAB 代码文件。

个性化代码视图外观

您可以自定义代码在代码视图编辑器中的显示方式。要更改您的代码视图预设项，请转至 MATLAB 桌面的主页选项卡。在环境部分中，点击预设。

更改颜色设置

要更改代码的可编辑部分的颜色设置并自定义语法高亮，请选择 MATLAB > 颜色，并调整桌面工具颜色和 MATLAB 语法高亮颜色。这些设置会同时影响 App 设计工具的代码视图编辑器和 MATLAB 编辑器。有关详细信息，请参阅更改桌面颜色。

要更改代码的不可编辑部分的背景颜色，请选择 MATLAB > App 设计工具，并调整只读背景颜色。仅在 MATLAB > 颜色预设项中的使用系统颜色选项未选中时，才能更改此设置。

更改制表符预设项

要在代码视图编辑器中指定制表符和缩进的大小，请选择 MATLAB > 编辑器/调试器 > Tab 键。在此处，您可以指自定义制表符和缩进的大小，以及有关制表符行为的详细信息。这些预设项会同时影响 App 设计工具的代码视图编辑器和 MATLAB 编辑器。有关详细信息，请参阅编辑器/调试器制表符预设项。