ON() Function Returns Command Assigned to Handle Event

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

SUMMARY

The ON() function returns the command that is assigned to handle the specified class of events. The ON ERROR, ON ESCAPE, ON KEY LABEL, ON PAGE, and ON READERROR commands specify the command that handles the corresponding class of events. The ON() function is new in FoxPro version 2.0 for MS-DOS.

MORE INFORMATION

The syntax for the ON() function is as follows

   ON(<expC1> [, <expC2>])

   Command             <expC1>
   -------             -------

   ON ERROR            ERROR
   ON ESCAPE           ESCAPE
   ON KEY              KEY
   ON KEY LABEL        KEY
   ON PAGE             PAGE
   ON READERROR        READERROR

The following are examples of using the ON() function:

X=ON("error")              Returns the command assigned in an ON ERROR
                           statement.

?ON("KEY","F4")            Returns the command assigned to the F4 key
                           in an ON KEY LABEL statement.

IF ON("PAGE")="DO MyUdf"   Compares the command assigned to ON PAGE to
                           the character string "DO MyUdf" and returns
                           .T. or .F.