Wait for click or key press
w = waitforbuttonpress
w = waitforbuttonpress blocks statements from executing until the
user has clicked a mouse button or pressed a key in the current figure.
The return argument,
w, can have the following values:
0 if it detects a click
1 if it detects a key press
waitforbuttonpress function does not return a value when any of
the following keys are pressed by themselves or together: Ctrl,
Shift, Alt, Caps Lock, Num
Lock, or Scroll Lock.
Create a figure and call the
function. Then, create axes and note that they do not appear.
figure; w = waitforbuttonpress; axes;
Click the figure. Now,
waitforbuttonpress returns, execution
continues, and the axes appear.
Some important points to consider when using
WindowButtonDownFcn is defined for the figure, it executes
waitforbuttonpress returns a value.
waitforbuttonpress function errors if the user closes the
figure by clicking the window close button unless your code calls the
waitforbuttonpress function within a
Behavior changed in R2014b
To resume program execution after the
is called, a click or key press must occur in the current figure, and not just any figure.
This change in behavior was introduced in order to prevent program execution from proceeding
in an unintended figure. Prior to R2014b,
detect a click or key press event in any open figure. The execution stream would then resume
in the figure in which the event was detected.