GETAPPLYKEY()
 Aplica una tecla a un objeto Get en una operación de lectura
------------------------------------------------------------------------------
 Sintaxis

     GETAPPLYKEY(<oGet>, <nTecla>, <ListaGet>, <oMenú>,
        <nFilaMsj>, <nIzqMsj>, <nDerMsj>, <cColorMsj>)
        --> NIL

 Argumentos

     <oGet> es una referencia a un objeto Get.

     <nTecla> es el valor de INKEY() que se va aplicar a <oGet>.

     <ListaGet> es una referencia a la lista actual de objetos Get.

     <oMenú> es una referencia a una barra de menús superior.

     <nFilaMsj> es un valor numérico que representa la fila de la barra
     de mensajes.

     <nIzqMsj> es un valor numérico que representa la columna izquierda
     de la barra de mensajes.

     <nDerMsj> es un valor numérico que representa la columna derecha de
     la barra de mensajes.

     <cColorMsj> es una cadena de caracteres que representa los colores
     que se van a utilizar para el texto de la barra de mensajes.

 Devuelve

     GETAPPLYKEY() devuelve siempre NIL.

 Descripción

     GETAPPLYKEY() es una función del sistema Get que aplica un valor
     devuelto por INKEY() a un objeto Get. El valor de las teclas produce
     en el objeto Get los resultados habituales. Es decir, las teclas de
     movimiento del cursor cambian la posición del cursor dentro del GET,
     las teclas que corresponden a datos se introducen en el GET, etc.

     Si la tecla que se pasa a GETAPPLYKEY() es una tecla SET KEY,
     GETAPPLYKEY() ejecuta SET KEY y retorna; la tecla no se aplica al
     objeto Get.

 Notas

     ■ Foco de entrada: El objeto Get debe tener el foco de entrada
        antes de aplicar las teclas. Si desea más información, consulte
        Get:setFocus y Get:killFocus

     ■ CLEAR GETS: El objeto Get debe tener el foco de entrada antes de
        aplicar las teclas. Si desea más información, consulte Get:setFocus
        y Get:killFocus.

 Ejemplos

     Este ejemplo aplica las pulsaciones de teclas hasta que se cumple la
     condición de salida del bucle:

     WHILE (oGet:exitState == GE_NOEXIT)
           GETAPPLYKEY (oGet, INKEY(0), GetLista, oMenu, nFilaMsj,;
           nIzqMsj, nDerMsj, nColorMsj)
        ENDDO

 Ficheros   La biblioteca asociada es CLIPPER.LIB,
            el fichero fuente asociado es Getsys.prg.

 To download this example - click here.

See Also: GETDOSETKEY() GETPOSTVALID() GETPREVALID()