waitforbuttonpress

等待点击或按键

全页折叠

语法

w = waitforbuttonpress

说明

注意

推荐使用 uiwait 并指定调用 uiresume 的 WindowButtonDownFcn 或 WindowKeyPressFcn 回调，而不是使用 waitforbuttonpress，因为前者可以更好地控制 App 行为。有关详细信息，请参阅替代功能。

w = waitforbuttonpress 用于阻止语句执行，直到用户点击了鼠标按键或在当前图窗中按下某个键。

返回参量 w 可以具有以下值：

  • 0（如果检测到点击）

  • 1（如果检测到按键动作）

当单独按下或作为组合键按下以下任何键时，waitforbuttonpress 函数不返回值：Ctrl、Shift、Alt、Caps Lock、Num Lock 或 Scroll Lock。

示例

示例

全部折叠

创建一个图窗并调用 waitforbuttonpress 函数。然后，创建坐标区并注意它们不会出现。

figure;
w = waitforbuttonpress;
axes;

点击图窗。现在，waitforbuttonpress 返回，执行继续，并显示坐标区。

提示

算法

使用 waitforbuttonpress 时要注意的一些重要内容：

  • 如果为图窗了定义 WindowButtonDownFcn，则它在 waitforbuttonpress 返回值之前执行。

  • 除非您的代码是调用 try/catch 块中的 waitforbuttonpress 函数，否则当用户通过点击窗口关闭按钮来关闭图窗时，waitforbuttonpress 函数会出错。

替代功能

使用 uiwait 以阻止语句执行。要在 App 用户点击鼠标按键或按下某个键时恢复程序执行，请指定调用 uiresume 的 WindowButtonDownFcn 或 WindowKeyPressFcn 回调。

例如，以下代码创建一个 UI 图窗，当用户在图窗窗口中点击时，该图窗将恢复程序执行。

fig = uifigure('WindowButtonDownFcn',@(src,event)uiresume(src));

调用 uiwait 以阻止程序执行，直到调用了 uiresume 或删除了图窗。创建一个 UIAxes 对象，并将图窗作为其父级。坐标区不出现。

uiwait(fig);
ax = uiaxes(fig);

然后，点击图窗。程序继续执行，出现 UIAxes 对象。

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

| | | | |