Skip to main content
Version: v20 R4 BETA

On After Keystroke

CodeCan be called byDefinition
284D Write Pro area - Combo Box - Form - Input - List Box - List Box ColumnA character is about to be entered in the object that has the focus. Get edited text returns the object's text including this character.
History
VersionChanges
v18 R5- Support in non-enterable list boxes - The event is now triggered after IME validation

Description

The On After Keystroke event can generally be replaced by the On After Edit event (see below).

After the On Before Keystroke and On After Keystroke event properties are selected for an object, you can detect and handle the keystrokes within the object, using the FORM event command that will return On Before Keystroke and then On After Keystroke (for more information, please refer to the description of the Get edited text command).

These events are also activated by language commands that simulate a user action like POST KEY.

The On After Keystroke event is not generated:

  • in list box columns method except when a cell is being edited (however it is generated in any cases in the list box method),
  • when user modifications are not carried out using the keyboard (paste, drag-and-drop, checkbox, drop down list, combo box). To process these events, you must use On After Edit.

Keystroke sequence

When an entry requires a sequence of keystrokes, the On Before Keystroke and [On After Keystroke event] events are generated only when the entry is fully validaded by the user. The Keystroke command returns the validated character. This case mainly occurs:

  • when using "dead" keys such as ^ or ~: events are generated only when the extended character is eventuelly entered (e.g. "ê" or ñ),
  • when an IME (Input Code Editor) displays an intermediary dialog box where the user can enter a combination of characters: events are generated only when the IME dialog is validated.

See also

On Before Keystroke.