Wait for click or key press
Use this function only with GUIDE, or with apps created with the
figure function.
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
The 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.
To determine the last key pressed, the mouse selection type, or the location of the
mouse pointer within the current figure, query the Figure properties
CurrentCharacter,
SelectionType, and CurrentPoint,
respectively.
Some important points to consider when using waitforbuttonpress:
If a WindowButtonDownFcn is defined for the figure, it executes
before waitforbuttonpress returns a value.
The waitforbuttonpress function errors if the user closes the
figure by clicking the window close button unless your code calls the
waitforbuttonpress function within a try/catch block.