performTextPaste

Pastes text into the matched JTextComponent over its current selection, then settles the composition.

The text goes through the component's own TransferHandler, as a paste does, so a DocumentFilter sees one replace rather than a keystroke each. Nothing is put on the system clipboard.

A paste runs no key binding, so it carries content a component's keys will not produce - a tab into a single-line field, say. The document still applies its own rules: a single-line field replaces a pasted newline with a space.

Fails where the component has no TransferHandler, or where the handler refuses the text.

Return

this interaction, for chaining a further gesture or assertion.

Parameters

text

handed to the handler as plain text, so no formatting a real clipboard could carry is part of it.