ON( ) (Función)

  • Artículo

Devuelve el comando asignado a cada uno de los siguientes comandos de control de eventos: ON ERROR, ON ESCAPE, ON KEY LABEL u ON PAGE.

ON(cONCommand [, KeyLabelName])

Valores devueltos

Character

Parámetros

  • cONCommand
    Especifica uno de los comandos de control de eventos. A continuación se indican los comandos y las expresiones de caracteres correspondientes que se usan con ON( ):

    Comando cONCommand
    ON ERROR ERROR
    ON ESCAPE ESCAPE
    ON KEY LABEL KEY
    ON PAGE PAGE

    Por ejemplo, para devolver el comando asignado actualmente a ON ERROR, utilice el comando siguiente:

    ? ON('ERROR')

  • KeyLabelName
    Se utiliza en ON KEY LABEL para especificar la tecla o combinación de teclas a las que se ha asignado el comando. Especifique KEY en cONCommand, y el nombre de la etiqueta de la tecla o combinación de teclas en KeyLabelName. Si desea consultar una lista completa de nombres de etiqueta de tecla, vea ON KEY LABEL.

    Por ejemplo, para devolver el comando asignado actualmente a la tecla de función F7 con ON KEY LABEL, utilice:

    ? ON('KEY', 'F7')

Observaciones

Cuando se produce un evento interceptado por alguno de los comandos de control de eventos, se ejecuta el comando asignado por el comando de control de eventos. ON( ) devuelve el comando que ha asignado como comando de control de eventos. ON( ) devuelve una cadena vacía si un comando no está asignado actualmente al comando de control de eventos que especifique.

Ejemplo

El ejemplo siguiente utiliza ON( ) para mostrar la configuración de ON ERROR y ON KEY LABEL.

ON ERROR DO errorhand
ON KEY LABEL CTRL+F2 WAIT WINDOW 'You pressed ^F2'
ON KEY LABEL ALT+Z DISPLAY MEMORY
CLEAR
? ON('ERROR')  && Displays DO errorhand
? ON('KEY', 'CTRL+F2')  && Displays WAIT WINDOW 'You pressed ^F2'
? ON('KEY', 'ALT+Z')  && Displays DISPLAY MEMORY
ON ERROR
ON KEY LABEL CTRL+F2
ON KEY LABEL ALT+Z

Vea también

INKEY( ) | LASTKEY( ) | ON ERROR | ON ESCAPE | ON KEY | ON KEY LABEL | ON PAGE | ON READERROR | READKEY( )