DOCUMENT:Q92350  19-JUN-1999  [foxpro]
TITLE   :INFO: Use the FoxPro ON KEY Command
PRODUCT :Microsoft FoxPro
PROD/VER:MS-DOS:2.0,2.5,2.5a; WINDOWS:2.5,2.5a,3.0
OPER/SYS:
KEYWORDS:kbGrpDSFox

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Visual FoxPro for Windows, version 3.0 
 - Microsoft FoxPro for MS-DOS, versions 2.0, 2.5, 2.5a 
 - Microsoft FoxPro for Windows, versions 2.5, 2.5a 
-------------------------------------------------------------------------------

SUMMARY
=======

The ON KEY command clears all previous ON KEY LABEL commands. However, the ON
KEY LABEL <keyname> commands clears only the specified key.

The following sample application demonstrates how the ON KEY command works by
displaying an appropriate message when the user presses one of the arrow keys:

   SET TALK OFF
      CLEAR
      mexit=.F.
      ON ESCAPE mexit=.T.
      ON KEY LABEL RIGHTARROW ? "Right Arrow"
      ** Sets ON KEY LABEL for right arrow to display "Right Arrow".

      ON KEY LABEL LEFTARROW ? "Left Arrow"
      ** Sets ON KEY LABEL for left arrow to display "Left Arrow".

      ON KEY LABEL UPARROW ? "Up Arrow"
      ** Sets on key label for up arrow to display the "Up Arrow".

      ON KEY LABEL DNARROW ? "Down Arrow"
      ** Sets on key label for down arrow to display "Down Arrow".

      @ 0,0 SAY "Press any arrow key or Press <Escape> to exit"
      DEFINE WINDOW menter FROM 10,20 TO 14,60 DOUBLE
      ACTIVATE WINDOW menter
      DO WHILE NOT mexit
      ENDDO
      DEACTIVATE WINDOW menter
      ON KEY LABEL RIGHTARROW
      ** This statement removes the ON KEY LABEL for the right arrow only.

      ON KEY
      ** This statement removes all remaining ON KEY LABEL assignments.

Additional query words: reset

======================================================================
Keywords          : kbGrpDSFox 
Technology        : kbVFPsearch kbAudDeveloper kbFoxproSearch kbZNotKeyword3 kbFoxPro200DOS kbFoxPro250DOS kbFoxPro250aDOS kbFoxPro250 kbFoxPro250a kbVFP300
Version           : MS-DOS:2.0,2.5,2.5a; WINDOWS:2.5,2.5a,3.0
Issue type        : kbinfo

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 1999.