KetraTerm
API · DevelopmentAll versions

complete

fun complete(text: String): Boolean

Completes this request with host-approved text, without reading a clipboard.

An EDT attempt consumes the request before callbacks, even for empty text, stale authority, rejected admission, or a propagated callback failure. Later attempts return false. Calls outside the EDT return false without consuming the request.

The original binding must remain current, including across suggestion invalidation callbacks. Rebinding, even to the same session, unbinding, closure, and disposal reject completion. Settings changes retain the issued request and its captured source; the session's current paste policy and modes apply at completion. Nonempty eligible input invalidates suggestions.

Return

true only when the original session admits this paste. Admission does not promise transport completion or shell acknowledgement.