If SavePoint was not called, this function aborts the calling command and displays an error message in the Vocola Log window.

CopyTouch and return

touchAndReturn(x,y) := SavePoint() Touch($x,$y) MoveToSavedPoint();
Play That = touchAndReturn(322, 70);
Stop That = touchAndReturn(476, 70);

The commands in this example (for the sound editor Audacity) use pointer coordinates to click buttons which lack labels and keyboard shortcuts. "Play That" clicks the "play" button and "Stop That" clicks the "stop" button. To avoid losing the current pointer position both commands use the touchAndReturn user function, which saves the current pointer position using SavePoint, clicks the appropriate button using Touch, and restores the pointer position using MoveToSavedPoint.