How to Undo ON KEY LABEL ENTER Command After Error

• Microsoft FoxPro for Windows, versions 2.5, 2.5a, 2.5b, and 2.6
• Microsoft FoxPro for MS-DOS, versions 2.5, 2.5a, 2.5b, and 2.6

SUMMARY

Under certain circumstances, you may want to redefine the ENTER key so that it performs an action, such as executing a procedure. However, if an error occurs during development before the ENTER key is returned to its original state, no commands can be entered in the Command window, and the statement following the ON KEY LABEL ENTER command will attempt to execute instead.

MORE INFORMATION

Issuing the command "ON KEY LABEL ENTER <function or command>" prior to the point at which that action is desired will cause that statement to be executed when the ENTER key is pressed. To return the ENTER key to its normal functionality, the command "ON KEY LABEL ENTER" (with nothing following it) should be the first line of code in the procedure or function (or the second line if there is a PARAMETER statement).

However, errors may occur before the line returning the ENTER key to the default is executed, preventing the ENTER key from terminating commands in the Command window. The following methods will allow you to restore the normal functionality of the ENTER key.

After returning to the Command window from the error condition, do the following:

Method 1

1. In FoxPro for MS-DOS, choose Macros from the System menu. In FoxPro for Windows, choose Macros from the Program menu.

2. Select an unused default macro, such as F3.

3. Choose the Edit button.

4. Type the following:

         ON KEY LABEL enter{LITERAL+ENTER}
   

5. Choose OK twice to close the Edit and Macros windows.

6. Press the macro key you just assigned.

Method 2

1. From the File menu, choose New. In the New File dialog box, choose Program and then choose New.

2. In the UNTITLED.PRG window, type the following command:

         ON KEY LABEL ENTER
   

3. Press CTRL+O to execute the program and choose Yes to save changes. Type a name for the program and then choose Save.