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

等待点击或按键

示例

注意

在 App 设计工具和使用 uifigure 函数创建的 App 中，推荐使用 uiwait 并指定调用 uiresume 的 WindowButtonDownFcn 或 WindowKeyPressFcn 回调，而不推荐使用 waitforbuttonpress，因为这样可以更好地控制 App 行为。有关详细信息，请参阅替代功能。

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

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

0（如果检测到点击）

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

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

全部折叠

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

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

要确定按下的最后一个键、鼠标选择类型或当前图窗中鼠标指针的位置，请分别查询 Figure 属性 CurrentCharacter、SelectionType 和 CurrentPoint。

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

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

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

在 App 设计工具和使用 uifigure 函数创建的 App 中，使用 uiwait 阻止语句执行。要在 App 用户点击鼠标按键或按下某个键时恢复程序执行，请指定调用 uiresume 的 WindowButtonDownFcn 或 WindowKeyPressFcn 回调。

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

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

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

全部展开

要在调用 waitforbuttonpress 函数后恢复程序执行，必须在当前图窗（而不是任何图窗）中点击或按键。引入这种行为更改是为了防止程序在非目标图窗中继续执行。在 R2014b 之前，waitforbuttonpress 会检测任何打开的图窗中的点击或按键事件。然后，执行流将在检测到事件的图窗中恢复。

uiwait | uiresume | dragrect | ginput | waitfor | figure