performTyping

Types text on the matched node one character at a time, then settles the composition.

Each character arrives as the KEY_PRESSED, KEY_TYPED, KEY_RELEASED triple the toolkit delivers for it, each from an event-queue cycle of its own, so the component's own key bindings decide what it does with each one. A text component inserts a character at its caret through its document filter and editor actions; a key it binds an action to runs that action instead, so a tab and a newline type into a text area and do nothing in a single-line field. Content a component's keys will not produce goes in with performTextPaste.

The character carries its own case: an upper-case letter is typed as itself, with no Shift held. Type a shortcut, or any key that is not a character, with performKeyPress.

text may be in any script and any plane. A character outside the Basic Multilingual Plane travels as its two UTF-16 units, one KEY_TYPED each, because a key event carries a single char, and the document reassembles it.

This delivers only keystrokes, so it does not exercise a component that reads committed text off an InputMethodEvent.

Parameters