Compartir a través de

KeyPress (Evento)

  • Artículo

Se produce cuando el usuario presiona y suelta una tecla.

PROCEDURE Object.KeyPress
LPARAMETERS [nIndex,] nKeyCode, nShiftAltCtrl

Parámetros

Es necesario incluir una instrucción LPARAMETERS o PARAMETERS en el procedimiento de evento y especificar un nombre para cada parámetro.

  • nIndex
    Identifica de forma única un control si está en una matriz de controles.

  • nKeyCode
    Contiene un número que identifica la tecla presionada. Si desea consultar una lista de códigos para claves especiales y combinaciones de clave, vea INKEY( ).

  • nShiftAltCtrl
    Establece un bit si se mantiene presionada una tecla modificadora mientras se presiona la tecla identificada en nKeyCode.

    Las teclas modificadoras válidas son MAYÚS, CTRL y ALT.

    Los valores devueltos en nShiftAltCtrl para teclas modificadoras individuales se enumeran en la siguiente tabla.

    Valores de teclas modificadoras para nShiftAltCtrl

    Tecla Valor
    MAYÚS 1
    CTRL 2
    ALT 4

    Este parámetro es la suma de varios bits, donde los menos significativos corresponden a la tecla MAYÚSCULAS (bit 0), a la tecla CTRL (bit 1) y a la tecla ALT (bit 2).

    Estos bits corresponden a los valores 1, 2 y 4, respectivamente. El parámetro indica el estado de estas teclas. Es posible que algunos de los bits, todos ellos, o ninguno, estén establecidos, lo que indicará que algunas, todas o ninguna de las teclas correspondientes están presionadas. Por ejemplo, si se presionan CTRL y ALT, el valor de nShiftAltCtrl es 6.

Observaciones

El objeto con el foco recibe el evento.

Un formulario puede recibir el evento KeyPress en dos situaciones especiales:

  • El formulario no contiene controles o ninguno de sus controles está visible y activado.
  • La propiedad KeyPreview del formulario está establecida en el valor verdadero (.T.). El formulario recibe primero el evento KeyPress y, a continuación, el control con el foco recibe el evento.
  • Si un control del formulario no puede procesar una pulsación (por ejemplo, cuando se presiona Tabulador para mover el enfoque al siguiente control).

Un evento KeyPress es útil para interceptar pulsaciones de teclas introducidas en un control. Permite comprobar inmediatamente la validez de las pulsaciones o dar formato a caracteres a medida que se escriben. Utilice la propiedad KeyPreview para crear rutinas globales de control del teclado.

El evento KeyPress no tiene lugar para las combinaciones de teclas que incluyan la tecla ALT.

Vea también

INKEY( ) | KeyPreview (Propiedad)

Se aplica a: CheckBox | ComboBox | CommandButton | EditBox | Form | ListBox | OptionButton | Spinner | TextBox