Android APIs
public interface

InputMethodSession

android.view.inputmethod.InputMethodSession
Known Indirect Subclasses

Class Overview

The InputMethodSession interface provides the per-client functionality of InputMethod that is safe to expose to applications.

Applications will not normally use this interface themselves, instead relying on the standard interaction provided by TextView and EditText.

Summary

Nested Classes
interface InputMethodSession.EventCallback  
Public Methods
abstract void appPrivateCommand(String action, Bundle data)
Process a private command sent from the application to the input method.
abstract void dispatchGenericMotionEvent(int seq, MotionEvent event, InputMethodSession.EventCallback callback)
This method is called when there is a generic motion event.
abstract void dispatchKeyEvent(int seq, KeyEvent event, InputMethodSession.EventCallback callback)
This method is called when a key is pressed.
abstract void dispatchTrackballEvent(int seq, MotionEvent event, InputMethodSession.EventCallback callback)
This method is called when there is a track ball event.
abstract void displayCompletions(CompletionInfo[] completions)
Called by a text editor that performs auto completion, to tell the input method about the completions it has available.
abstract void finishInput()
This method is called when the application would like to stop receiving text input.
abstract void toggleSoftInput(int showFlags, int hideFlags)
Toggle the soft input window.
abstract void updateCursor(Rect newCursor)
This method is called when cursor location of the target input field has changed within its window.
abstract void updateCursorAnchorInfo(CursorAnchorInfo cursorAnchorInfo)
This method is called when the cursor and/or the character position relevant to text input is changed on the screen.
abstract void updateExtractedText(int token, ExtractedText text)
Called by a text editor to report its new extracted text when its contents change.
abstract void updateSelection(int oldSelStart, int oldSelEnd, int newSelStart, int newSelEnd, int candidatesStart, int candidatesEnd)
This method is called when the selection or cursor in the current target input field has changed.
abstract void viewClicked(boolean focusChanged)
This method is called when the user tapped a text view.

Public Methods

public abstract void appPrivateCommand (String action, Bundle data)

Added in API level 3

Process a private command sent from the application to the input method. This can be used to provide domain-specific features that are only known between certain input methods and their clients.

Parameters
action Name of the command to be performed. This must be a scoped name, i.e. prefixed with a package name you own, so that different developers will not create conflicting commands.
data Any data to include with the command.

public abstract void dispatchGenericMotionEvent (int seq, MotionEvent event, InputMethodSession.EventCallback callback)

Added in API level 17

This method is called when there is a generic motion event.

If the input method wants to handle this event, return true, otherwise return false and the caller (i.e. the application) will handle the event.

Parameters
event The motion event.
Returns
  • Whether the input method wants to handle this event.
See Also

public abstract void dispatchKeyEvent (int seq, KeyEvent event, InputMethodSession.EventCallback callback)

Added in API level 3

This method is called when a key is pressed. When done with the event, the implementation must call back on callback with its result.

If the input method wants to handle this event, return true, otherwise return false and the caller (i.e. the application) will handle the event.

Parameters
event The key event.
Returns
  • Whether the input method wants to handle this event.

public abstract void dispatchTrackballEvent (int seq, MotionEvent event, InputMethodSession.EventCallback callback)

Added in API level 3

This method is called when there is a track ball event.

If the input method wants to handle this event, return true, otherwise return false and the caller (i.e. the application) will handle the event.

Parameters
event The motion event.
Returns
  • Whether the input method wants to handle this event.
See Also

public abstract void displayCompletions (CompletionInfo[] completions)

Added in API level 3

Called by a text editor that performs auto completion, to tell the input method about the completions it has available. This can be used by the input method to display them to the user to select the text to be inserted.

Parameters
completions Array of text completions that are available, starting with the best. If this array is null, any existing completions will be removed.

public abstract void finishInput ()

Added in API level 3

This method is called when the application would like to stop receiving text input.

public abstract void toggleSoftInput (int showFlags, int hideFlags)

Added in API level 3

Toggle the soft input window. Applications can toggle the state of the soft input window.

Parameters
showFlags Provides additional operating flags. May be 0 or have the SHOW_IMPLICIT, SHOW_FORCED bit set.
hideFlags Provides additional operating flags. May be 0 or have the HIDE_IMPLICIT_ONLY, HIDE_NOT_ALWAYS bit set.

public abstract void updateCursor (Rect newCursor)

Added in API level 3

This method is called when cursor location of the target input field has changed within its window. This is not normally called, but will only be reported if requested by the input method.

Parameters
newCursor The rectangle of the cursor currently being shown in the input field's window coordinates.

public abstract void updateCursorAnchorInfo (CursorAnchorInfo cursorAnchorInfo)

This method is called when the cursor and/or the character position relevant to text input is changed on the screen. This is not called by default. It will only be reported if requested by the input method.

Parameters
cursorAnchorInfo Positional information relevant to text input, such as text insertion point and composition string.

public abstract void updateExtractedText (int token, ExtractedText text)

Added in API level 3

Called by a text editor to report its new extracted text when its contents change. This will only be called if the input method calls InputConnection.getExtractedText() with the option to report updates.

Parameters
token The input method supplied token for identifying its request.
text The new extracted text.

public abstract void updateSelection (int oldSelStart, int oldSelEnd, int newSelStart, int newSelEnd, int candidatesStart, int candidatesEnd)

Added in API level 3

This method is called when the selection or cursor in the current target input field has changed.

Parameters
oldSelStart The previous text offset of the cursor selection start position.
oldSelEnd The previous text offset of the cursor selection end position.
newSelStart The new text offset of the cursor selection start position.
newSelEnd The new text offset of the cursor selection end position.
candidatesStart The text offset of the current candidate text start position.
candidatesEnd The text offset of the current candidate text end position.

public abstract void viewClicked (boolean focusChanged)

Added in API level 14

This method is called when the user tapped a text view. IMEs can't rely on this method being called because this was not part of the original IME protocol, so applications with custom text editing written before this method appeared will not call to inform the IME of this interaction.

Parameters
focusChanged true if the user changed the focused view by this click.