Saltar al contenido principal
Versión: 20 R6

On Before Keystroke

CodePuede ser llamado porDefinición
17Área 4D Write Pro - Combo Box - Formulario - Entrada - List Box - Columna de list BoxUn personaje está a punto de ser introducido en el objeto que tiene el foco. Get edited text devuelve el texto del objeto sin este carácter.
Historia
LanzamientoModificaciones
18 R5- Soporte en list boxes no editables - El evento se activa ahora después de la validación IME

Descripción

Después de que se seleccionen los eventos On Before Keystroke y On After Keystroke para un objeto, puede detectar y manejar las pulsaciones de teclas dentro del objeto, utilizando el comando Form event code que devolverá On Before Keystroke y luego On After Keystroke (para más información, consulte la descripción del comando Get edited text). En el evento On Before Keystroke, se puede utilizar el comando FILTER KEYSTROKE para filtrar los caracteres digitados.

Estos eventos también son activados por comandos del lenguaje que simulan una acción del usuario como POST KEY.

El evento On Before Keystroke no se genera:

  • en un método columnas de list box excepto cuando se está editando una celda (sin embargo se genera en cualquier caso en el método de list box),
  • cuando las modificaciones usuario no se realizan con el teclado (pegar, arrastrar y soltar, casilla de verificación, lista desplegable, combo box). Para procesar estos eventos, debe utilizar On After Edit.

Objetos no editables

El evento On Before Keystroke puede generarse en objetos no introducibles, por ejemplo, en un list box aunque las celdas del list box no sean introducibles, o las líneas no sean seleccionables. Esto permite crear interfaces en las que el usuario puede desplazarse dinámicamente a una línea específica en un list box introduciendo las primeras letras de un valor. En el caso de que las celdas del cuadro del list box sean editables, puede utilizar el comando Is editing text para saber si el usuario está realmente introduciendo texto en una celda o está utilizando la función de tecleo predictivo y entonces, ejecuta

Secuencia de tecla

Cuando una entrada requiere una secuencia de pulsaciones de teclas, los eventos On Before Keystroke y On After Keystroke se generan solo cuando la entrada es completamente validada por el usuario. El comando Keystroke devuelve el carácter validado. Este caso se da principalmente:

  • cuando se utilizan las teclas "muertas" como ^ o ~: los eventos se generan sólo cuando se introduce el carácter extendido eventualmente (por ejemplo, "ê" o ñ),
  • cuando un IME (Input Code Editor) muestra una caja de diálogo intermedia en la que el usuario puede introducir una combinación de caracteres: los eventos se generan sólo cuando el diálogo IME se valida.

Ver también

On After Keystroke.