+---------------------------------+
|           PLAY MACRO            |
+---------------------------------+
PLAY MACRO <macro name>
        [TIME <expN>]

-----------------------------------
Executes keyboard macro.
-----------------------------------

FoxPro allows you to save a series of keystrokes as a keyboard macro.
PLAY MACRO replays this series of keystrokes.  Playing keyboard macros
within programs lets you create self-running demos.

Once a keyboard macro has been saved, it can also be played back by
pressing the key or keys you specified to identify the macro.

If PLAY MACRO is issued from the Command window, it is immediately
executed.  If PLAY MACRO is issued in a program, execution is delayed
until an opportunity to input keystrokes arises.  Any place where input
is required will be where PLAY MACRO replays the keystrokes.  Examples
of commands that wait for input are @ ... SAY/GET, CHANGE, EDIT, etc.

WARNING - If a series of PLAY MACRO commands are pending, they are not
executed in the order in which they are issued.  Macros are played
within a program in reverse order - the first PLAY MACRO is executed
last, the last PLAY MACRO is executed first. The PLAY MACRO commands are
executed from bottom to top order as the appear within the program.

Clauses
-------

<macro name>
        The keyboard macro you would like to play.

TIME <expN>
        The time interval between the delivery of keystrokes in a keyboard
macro.  Specify a TIME delay between 0 and 10 seconds (fractional
seconds are permitted) in <expN>.  For example, if you specify <expN>
equal to 1, keystrokes from the macro will be replayed with a one second
delay between each keystroke.

-----------------------------------

See Also:  CLEAR, RESTORE MACROS, SAVE MACROS

-----------------------------------