在 App 设计工具中指定启动任务和 App 输入参量

R2026b

在 App 设计工具中，您可以创建一个特殊函数，该函数在 App 启动时、但在用户与 UI 交互之前执行。此函数称为 startupFcn 回调，它非常适用于设置默认值、定义 App 输入参量、初始化变量或执行影响 App 初始状态的命令。例如，您可以使用 startupFcn 回调来显示默认绘图或显示表中默认值的列表。

创建 `startupFcn` 回调

要创建一个 startupFcn 回调，请使用以下方法之一：

在代码视图中，在编辑器选项卡上，选择回调。或者，在代码浏览器窗格的回调选项卡上，点击按钮。选择 App 节点作为执行回调的组件，并选择 StartupFcn 作为回调属性。App 节点与您的 App 文件同名。
在组件浏览器中，右键点击 App 节点并选择回调 > 添加 StartupFcn 回调。App 节点与您的 App 文件同名。

App 设计工具会创建该函数并将光标置于函数的主体中。添加您要该函数在 App 启动时执行的命令。然后保存并运行 App。

Function definition for the startupFcn callback. The function is in a private methods block and has one input argument, named app.

有关具有 startupFcn 回调的 App 示例，请参阅创建可利用自动调整布局功能调整大小的 App。

定义输入 App 参量

您还可以使用 startupFcn 回调函数为您的 App 定义输入参量。通过输入参量，用户（或其他 App）可在 App 启动时指定初始值。

要将输入参量添加到 App，请在 App 设计工具中打开该 App 并点击代码视图。然后点击编辑器选项卡上的 App 输入参量 ，这将启动“App 详细信息”对话框。

App Details dialog box. The Code Options section of the dialog box contains an Input Arguments field for entering arguments for the startupFcn callback.

使用对话框中的输入参量字段添加或删除 startupFcn 回调的函数签名中的输入参量。对于输入参量，请输入逗号分隔的变量名称列表。您也可以输入 varargin 以使任何参量都是可选参量。然后点击确定。

点击确定后，App 设计工具会创建一个 startupFcn 回调。函数签名始终先有 app 输入参量，后跟您指定的输入参量。如果您的 App 已经有 startupFcn 回调，则函数签名会更新以包含新的输入参量。

创建输入参量并对 startupFcn 回调函数进行编码后，您可以测试该 App。展开工具条上的运行按钮菜单。在第二个菜单项中，为每个输入参量指定逗号分隔值。当您输入值并按 Enter 键后，App 将运行。

Run button menu options. The options are to run the app with no arguments, to run the app by specifying input arguments, and to edit app input arguments.