Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

App 设计工具中的回调

回调是在用户与 App 中的 UI 组件交互时执行的函数。您可以使用回调对 App 的行为进行编程。例如,您可以编写一个回调函数,用于在 App 用户点击按钮时绘制一些数据;或编写另一个回调函数,用于在用户与滑块交互时移动仪表组件的指针。

大多数组件有至少一个回调,每个回调与该组件的一个特定交互绑定。但是,某些组件(如标签和信号灯)没有回调,因为这些组件仅显示信息。要查看某个组件支持的回调的列表,请选择该组件,然后点击组件浏览器中的回调选项卡。

创建回调函数

为 UI 组件创建回调有多种方法。根据您在 App 设计工具中的工作位置,您可以采用不同方法。从列表中选择最方便的方法:

  • 右键点击画布中的一个组件、组件浏览器App 布局窗格,然后选择回调 > 添加(回调属性)回调

    Context menu associated with a slider component. Under the Callbacks menu item, there are options to add a ValueChangedFcn callback or a ValueChangingFcn callback.

  • 组件浏览器中选择回调选项卡。回调选项卡的左侧显示支持的回调属性。您可以通过每个回调属性旁边的下拉列表来指定回调函数的名称,也可以选择尖括号<>中的默认名称。如果您的 App 有现有回调,则下拉列表中会包含这些回调。当需要多个 UI 组件执行相同代码时,请选择一个现有回调。

    Callbacks tab of the Component Browser with a spinner component selected. There are options for a ValueChangedFcn callback and a ValueChangingFcn callback.

  • 在代码的代码视图中,在编辑器选项卡中点击 回调。或者,在代码浏览器窗格的回调选项卡上,点击 Plus 按钮。

    Add Callback Function dialog box. There are options to choose a component and a callback from drop-down lists, and to specify the callback function name.

    在“添加回调函数”对话框中指定这些选项:

    • 组件 - 指定执行回调的 UI 组件。

    • 回调 - 指定回调属性。回调属性将回调函数映射到特定交互。某些组件具有多个可用的回调属性。例如,滑块具有两个回调属性:ValueChangedFcnValueChangingFcnValueChangedFcn 回调在用户移动滑块并释放鼠标后执行。用户移动滑块时,同一组件的 ValueChangingFcn 回调会重复执行。

    • 名称 - 为回调函数指定名称。App 设计工具会提供默认名称,但您可以在文本字段中更改该名称。如果您的 App 有现有回调,则名称字段旁边会有一个下拉箭头,表示您可以从列表中选择一个现有回调。

回调函数编程

为组件创建回调时,App 设计工具会在代码视图中生成回调函数,并将光标放在该函数中。在此回调函数中编写代码,对回调行为进行编程。

回调输入参数

App 设计工具创建的所有回调函数的函数签名中都有这些输入参数:

  • app - app 对象。使用此对象访问 App 中的 UI 组件以及存储为属性的其他变量。

  • event - 包含有关 App 用户与 UI 组件交互的特定信息的对象。

app 参数为回调提供 app 对象。您可以使用以下语法访问任何回调中的任何组件(以及特定于组件的所有属性):

app.Component.Property

例如,以下命令将仪表的 Value 属性设置为 50。在此示例中,仪表的名称为 PressureGauge

app.PressureGauge.Value = 50;

event 参数提供具有不同属性的对象,具体取决于正在执行的特定回调。对象属性包含与回调响应的交互类型相关的信息。例如,滑块的 ValueChangingFcn 回调中的 event 参数包含一个名为 Value 的属性。该属性在用户移动滑块(释放鼠标之前)时存储滑块值。以下是一个滑块回调函数,它使用 event 参数使仪表跟踪滑块的值:

function SliderValueChanging(app,event)
      latestvalue = event.Value; % Current slider value
      app.PressureGauge.Value = latestvalue;  % Update gauge   
end
要了解有关特定组件回调函数的 event 参数的更多信息,请参阅该组件的属性页。右键点击组件,然后选择关于所选内容的帮助打开属性页。有关所有 UI 组件的属性页列表,请参阅 App 构建组件

在回调函数之间共享数据

要存储需要由多个回调访问的数据,请创建一个属性。属性包含属于 App 的数据。您可以创建私有属性来存储仅在 App 内部共享数据,或创建公共属性来存储要在 App 外部共享数据(例如,脚本、函数或其他需要访问数据的 App)。

代码视图编辑器选项卡中,点击 属性按钮,创建公共或私有属性。输入属性的名称。然后,您可以使用语法 app.PropertyName 在所有 App 回调中指定和访问属性值。

有关详细信息,请参阅在用 App 设计工具创建的 App 内共享数据

在多个组件之间共享回调

当您要在您的 App 中提供多种方法来执行某个操作时,在组件间共享回调非常有用。例如,当用户点击按钮或在编辑字段中按下 Enter 键时,App 可以用同样的方式响应。

为一个组件创建回调后,可以通过将其分配给另一个组件来共享它。在组件浏览器中右键点击第二个组件,然后选择回调 > 选择现有的回调。当显示“选择回调函数”对话框时,从名称下拉列表中选择现有的回调。

有关在两个组件之间共享回调的 App 的示例,请参阅对多个 App 设计工具组件使用一个回调

以编程方式创建和分配回调

您还可以在 App 代码中以编程方式创建和分配回调函数。使用此方法为未出现在组件浏览器中的组件或图形对象创建回调。例如,您可以通过编程方式将回调分配给在 App 代码中创建的对话框,或分配给在 UIAxes 组件中绘制的 Line 对象。

通过在工具条的编辑器选项卡中选择函数 > 私有函数,将回调函数创建为私有函数。该函数必须将 appsrcevent 作为前三个参数。下面是作为私有函数编写的回调的示例:

methods (Access = private)
    
        function myclosefcn(app,src,event)
            disp('Have a nice day!');
        end
        
end

使用语法 @app. FunctionName 将回调属性值指定为回调函数的句柄,这样可将回调函数分配给组件。例如,以下代码创建一个警报对话框,该对话框将 myclosefcn 函数分配给 CloseFcn 回调属性。该函数在对话框关闭时执行。

uialert(app.UIFigure,"File not found","Alert", ...
    "CloseFcn",@app.myclosefcn);

要编写接受附加输入参数的回调函数,请在前三个参数后指定附加参数。例如,以下回调接受一个额外的输入 name

methods (Access = private)
    
        function displaymsg(app,src,event,name)
            msg = name + " dialog box closed";
            disp(msg);
        end
        
end

要将此回调分配给一个组件,请将该组件的回调属性指定为元胞数组。该元胞数组中的第一个元素必须为函数句柄。后续元素必须为附加输入值。例如:

uialert(app.UIFigure,"File not found","Alert", ...
    "CloseFcn",{@app.displaymsg,"Alert"});

有关详细信息,请参阅以编程方式向 App 设计工具添加 UI 组件

在代码中搜索回调

如果您的 App 有很多回调,您可以通过在代码浏览器中的回调选项卡顶部的搜索栏中键入部分名称,以快速搜索并导航到特定回调。开始键入后,回调窗格的内容将被清除,但会显示符合搜索条件的回调。

Callbacks tab of the Code Browser. The search bar has the text "Slider" and the pane lists the SliderValueChanging function.

点击一个搜索结果以将回调滚动到视图中。右键点击搜索结果并选择转至会将光标置于回调函数中。

更改回调或断开与回调的连接

要为组件分配不同回调,请在组件浏览器中选择该组件。然后点击回调选项卡,并从下拉列表中选择不同回调。下拉列表仅显示现有回调。

Callbacks tab for an edit field component in the Component Browser. The ValueChangedFcn drop-down list is expanded, and two existing callback functions are listed.

要断开与组件共享的回调的连接,请在组件浏览器中选择该组件。然后点击回调选项卡,并从下拉菜单中选择 <没有回调>。选择此选项只会断开回调与组件的连接。它不会从代码中删除函数定义,也不会断开回调与任何其他组件的连接。断开与回调的连接后,您可以为组件创建新回调,或使组件保持为不使用回调函数。

删除回调

如果您的代码包含一个回调函数,而您的 App 中没有任何组件使用该函数,您可以完全删除该函数。右键点击代码浏览器回调选项卡中的回调并从上下文菜单中选择删除,可删除回调。

Callbacks tab of the Code Browser. The context menu associated with the StopButtonPushed callback function has options to delete, rename, insert at cursor, and go to.

示例:具有滑块回调的 App

以下 App 包含一个在用户移动滑块时跟踪滑块值的仪表。滑块的 ValueChangingFcn 回调从 event 参数中获取滑块的当前值。然后它使仪表指针指向该值。

相关主题