IT. Expert System.

All Implemented Interfaces:

InputConnection

public class InputConnectionWrapper
extends Object
implements InputConnection

• Field Summary

  • Fields inherited from interface android.view.inputmethod.InputConnection

    GET_EXTRACTED_TEXT_MONITOR, GET_TEXT_WITH_STYLES

• Constructor Summary

  Constructors

  Constructor and Description
  InputConnectionWrapper(InputConnection target, boolean mutable)

• Method Summary

  Methods

  Modifier and Type	Method and Description
  boolean	beginBatchEdit() Tell the editor that you are starting a batch of editor operations.
  boolean	clearMetaKeyStates(int states) Clear the given meta key pressed states in the given input connection.
  boolean	commitCompletion(CompletionInfo text) Commit a completion the user has selected from the possible ones previously reported to InputMethodSession.displayCompletions().
  boolean	commitCorrection(CorrectionInfo correctionInfo) Commit a correction automatically performed on the raw user's input.
  boolean	commitText(CharSequence text, int newCursorPosition) Commit text to the text box and set the new cursor position.
  boolean	deleteSurroundingText(int beforeLength, int afterLength) Delete beforeLength characters of text before the current cursor position, and delete afterLength characters of text after the current cursor position, excluding composing text.
  boolean	endBatchEdit() Tell the editor that you are done with a batch edit previously initiated with InputConnection.beginBatchEdit().
  boolean	finishComposingText() Have the text editor finish whatever composing text is currently active.
  int	getCursorCapsMode(int reqModes) Retrieve the current capitalization mode in effect at the current cursor position in the text.
  ExtractedText	getExtractedText(ExtractedTextRequest request, int flags) Retrieve the current text in the input connection's editor, and monitor for any changes to it.
  CharSequence	getSelectedText(int flags) Gets the selected text, if any.
  CharSequence	getTextAfterCursor(int n, int flags) Get n characters of text after the current cursor position.
  CharSequence	getTextBeforeCursor(int n, int flags) Get n characters of text before the current cursor position.
  boolean	performContextMenuAction(int id) Perform a context menu action on the field.
  boolean	performEditorAction(int editorAction) Have the editor perform an action it has said it can do.
  boolean	performPrivateCommand(String action, Bundle data) API to send private commands from an input method to its connected editor.
  boolean	reportFullscreenMode(boolean enabled) Called by the IME to tell the client when it switches between fullscreen and normal modes.
  boolean	sendKeyEvent(KeyEvent event) Send a key event to the process that is currently attached through this input connection.
  boolean	setComposingRegion(int start, int end) Mark a certain region of text as composing text.
  boolean	setComposingText(CharSequence text, int newCursorPosition) Set composing text around the current cursor position with the given text, and set the new cursor position.
  boolean	setSelection(int start, int end) Set the selection of the text editor.
  void	setTarget(InputConnection target) Change the target of the input connection.

  • Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

• Constructor Detail

  • InputConnectionWrapper

    public InputConnectionWrapper(InputConnection target,
                          boolean mutable)

• Method Detail

  • setTarget

    public void setTarget(InputConnection target)

    Change the target of the input connection.

  • getTextBeforeCursor

    public CharSequence getTextBeforeCursor(int n,
                                   int flags)

    Description copied from interface: InputConnection
    Get n characters of text before the current cursor position.

    This method may fail either if the input connection has become invalid (such as its process crashing) or the client is taking too long to respond with the text (it is given a couple seconds to return). In either case, a null is returned.

    Specified by:

    getTextBeforeCursor in interface InputConnection

    Parameters:

    n - The expected length of the text.

    flags - Supplies additional options controlling how the text is returned. May be either 0 or InputConnection.GET_TEXT_WITH_STYLES.

    Returns:

    Returns the text before the cursor position; the length of the returned text might be less than n.

  • getTextAfterCursor

    public CharSequence getTextAfterCursor(int n,
                                  int flags)

    Description copied from interface: InputConnection
    Get n characters of text after the current cursor position.

    This method may fail either if the input connection has become invalid (such as its process crashing) or the client is taking too long to respond with the text (it is given a couple seconds to return). In either case, a null is returned.

    Specified by:

    getTextAfterCursor in interface InputConnection

    Parameters:

    n - The expected length of the text.

    flags - Supplies additional options controlling how the text is returned. May be either 0 or InputConnection.GET_TEXT_WITH_STYLES.

    Returns:

    Returns the text after the cursor position; the length of the returned text might be less than n.

  • getSelectedText

    public CharSequence getSelectedText(int flags)

    Description copied from interface: InputConnection
    Gets the selected text, if any.

    This method may fail if either the input connection has become invalid (such as its process crashing) or the client is taking too long to respond with the text (it is given a couple of seconds to return). In either case, a null is returned.

    Specified by:

    getSelectedText in interface InputConnection

    Parameters:

    flags - Supplies additional options controlling how the text is returned. May be either 0 or InputConnection.GET_TEXT_WITH_STYLES.

    Returns:

    Returns the text that is currently selected, if any, or null if no text is selected.

  • getCursorCapsMode

    public int getCursorCapsMode(int reqModes)

    Description copied from interface: InputConnection
    Retrieve the current capitalization mode in effect at the current cursor position in the text. See TextUtils.getCapsMode for more information.

    This method may fail either if the input connection has become invalid (such as its process crashing) or the client is taking too long to respond with the text (it is given a couple seconds to return). In either case, a 0 is returned.

    Specified by:

    getCursorCapsMode in interface InputConnection

    Parameters:

    reqModes - The desired modes to retrieve, as defined by TextUtils.getCapsMode. These constants are defined so that you can simply pass the current TextBoxAttribute.contentType value directly in to here.

    Returns:

    Returns the caps mode flags that are in effect.

  • getExtractedText

    public ExtractedText getExtractedText(ExtractedTextRequest request,
                                 int flags)

    Description copied from interface: InputConnection
    Retrieve the current text in the input connection's editor, and monitor for any changes to it. This function returns with the current text, and optionally the input connection can send updates to the input method when its text changes.

    This method may fail either if the input connection has become invalid (such as its process crashing) or the client is taking too long to respond with the text (it is given a couple seconds to return). In either case, a null is returned.

    Specified by:

    getExtractedText in interface InputConnection

    Parameters:

    request - Description of how the text should be returned.

    flags - Additional options to control the client, either 0 or InputConnection.GET_EXTRACTED_TEXT_MONITOR.

    Returns:

    Returns an ExtractedText object describing the state of the text view and containing the extracted text itself.

  • deleteSurroundingText

    public boolean deleteSurroundingText(int beforeLength,
                                int afterLength)

    Description copied from interface: InputConnection
    Delete beforeLength characters of text before the current cursor position, and delete afterLength characters of text after the current cursor position, excluding composing text. Before and after refer to the order of the characters in the string, not to their visual representation.

    Specified by:

    deleteSurroundingText in interface InputConnection

    Parameters:

    beforeLength - The number of characters to be deleted before the current cursor position.

    afterLength - The number of characters to be deleted after the current cursor position.

    Returns:

    Returns true on success, false if the input connection is no longer valid.

  • setComposingText

    public boolean setComposingText(CharSequence text,
                           int newCursorPosition)

    Description copied from interface: InputConnection
    Set composing text around the current cursor position with the given text, and set the new cursor position. Any composing text set previously will be removed automatically.

    Specified by:

    setComposingText in interface InputConnection

    Parameters:

    text - The composing text with styles if necessary. If no style object attached to the text, the default style for composing text is used. See {#link android.text.Spanned} for how to attach style object to the text. {#link android.text.SpannableString} and {#link android.text.SpannableStringBuilder} are two implementations of the interface {#link android.text.Spanned}.

    newCursorPosition - The new cursor position around the text. If > 0, this is relative to the end of the text - 1; if <= 0, this is relative to the start of the text. so a value of 1 will always advance you to the position after the full text being inserted. note that this means you can't position the cursor within the text, because the editor can make modifications to the text you are providing so it is not possible to correctly specify locations there.

    Returns:

    Returns true on success, false if the input connection is no longer valid.

  • setComposingRegion

    public boolean setComposingRegion(int start,
                             int end)

    Description copied from interface: InputConnection
    Mark a certain region of text as composing text. Any composing text set previously will be removed automatically. The default style for composing text is used.

    Specified by:

    setComposingRegion in interface InputConnection

    Parameters:

    start - the position in the text at which the composing region begins

    end - the position in the text at which the composing region ends

    Returns:

    Returns true on success, false if the input connection is no longer valid.

  • finishComposingText

    public boolean finishComposingText()

    Description copied from interface: InputConnection
    Have the text editor finish whatever composing text is currently active. This simply leaves the text as-is, removing any special composing styling or other state that was around it. The cursor position remains unchanged.

    Specified by:

    finishComposingText in interface InputConnection

  • commitText

    public boolean commitText(CharSequence text,
                     int newCursorPosition)

    Description copied from interface: InputConnection
    Commit text to the text box and set the new cursor position. Any composing text set previously will be removed automatically.

    Specified by:

    commitText in interface InputConnection

    Parameters:

    text - The committed text.

    newCursorPosition - The new cursor position around the text. If > 0, this is relative to the end of the text - 1; if <= 0, this is relative to the start of the text. so a value of 1 will always advance you to the position after the full text being inserted. note that this means you can't position the cursor within the text, because the editor can make modifications to the text you are providing so it is not possible to correctly specify locations there.

    Returns:

    Returns true on success, false if the input connection is no longer valid.

  • commitCompletion

    public boolean commitCompletion(CompletionInfo text)

    Description copied from interface: InputConnection
    Commit a completion the user has selected from the possible ones previously reported to InputMethodSession.displayCompletions(). This will result in the same behavior as if the user had selected the completion from the actual UI.

    Specified by:

    commitCompletion in interface InputConnection

    Parameters:

    text - The committed completion.

    Returns:

    Returns true on success, false if the input connection is no longer valid.

  • commitCorrection

    public boolean commitCorrection(CorrectionInfo correctionInfo)

    Description copied from interface: InputConnection
    Commit a correction automatically performed on the raw user's input. A typical example would be to correct typos using a dictionary.

    Specified by:

    commitCorrection in interface InputConnection

    Parameters:

    correctionInfo - Detailed information about the correction.

    Returns:

    True on success, false if the input connection is no longer valid.

  • setSelection

    public boolean setSelection(int start,
                       int end)

    Description copied from interface: InputConnection
    Set the selection of the text editor. To set the cursor position, start and end should have the same value.

    Specified by:

    setSelection in interface InputConnection

    Returns:

    Returns true on success, false if the input connection is no longer valid.

  • performEditorAction

    public boolean performEditorAction(int editorAction)

    Description copied from interface: InputConnection
    Have the editor perform an action it has said it can do.

    Specified by:

    performEditorAction in interface InputConnection

    Parameters:

    editorAction - This must be one of the action constants for EditorInfo.editorType, such as EditorInfo.EDITOR_ACTION_GO.

    Returns:

    Returns true on success, false if the input connection is no longer valid.

  • performContextMenuAction

    public boolean performContextMenuAction(int id)

    Description copied from interface: InputConnection
    Perform a context menu action on the field. The given id may be one of: android.R.id#selectAll, android.R.id#startSelectingText, android.R.id#stopSelectingText, android.R.id#cut, android.R.id#copy, android.R.id#paste, android.R.id#copyUrl, or android.R.id#switchInputMethod

    Specified by:

    performContextMenuAction in interface InputConnection

  • beginBatchEdit

    public boolean beginBatchEdit()

    Description copied from interface: InputConnection
    Tell the editor that you are starting a batch of editor operations. The editor will try to avoid sending you updates about its state until InputConnection.endBatchEdit() is called.

    Specified by:

    beginBatchEdit in interface InputConnection

  • endBatchEdit

    public boolean endBatchEdit()

    Description copied from interface: InputConnection
    Tell the editor that you are done with a batch edit previously initiated with InputConnection.beginBatchEdit().

    Specified by:

    endBatchEdit in interface InputConnection

  • sendKeyEvent

    public boolean sendKeyEvent(KeyEvent event)

    Description copied from interface: InputConnection
    Send a key event to the process that is currently attached through this input connection. The event will be dispatched like a normal key event, to the currently focused; this generally is the view that is providing this InputConnection, but due to the asynchronous nature of this protocol that can not be guaranteed and the focus may have changed by the time the event is received.

    This method can be used to send key events to the application. For example, an on-screen keyboard may use this method to simulate a hardware keyboard. There are three types of standard keyboards, numeric (12-key), predictive (20-key) and ALPHA (QWERTY). You can specify the keyboard type by specify the device id of the key event.

    You will usually want to set the flag KeyEvent.FLAG_SOFT_KEYBOARD on all key event objects you give to this API; the flag will not be set for you.

    Note that it's discouraged to send such key events in normal operation; this is mainly for use with InputType.TYPE_NULL type text fields. Use the InputConnection.commitText(java.lang.CharSequence, int) family of methods to send text to the application instead.

    Specified by:

    sendKeyEvent in interface InputConnection

    Parameters:

    event - The key event.

    Returns:

    Returns true on success, false if the input connection is no longer valid.

    See Also:

    KeyEvent, KeyCharacterMap.NUMERIC, KeyCharacterMap.PREDICTIVE, KeyCharacterMap.ALPHA

  • clearMetaKeyStates

    public boolean clearMetaKeyStates(int states)

    Description copied from interface: InputConnection
    Clear the given meta key pressed states in the given input connection.

    Specified by:

    clearMetaKeyStates in interface InputConnection

    Parameters:

    states - The states to be cleared, may be one or more bits as per KeyEvent.getMetaState().

    Returns:

    Returns true on success, false if the input connection is no longer valid.

  • reportFullscreenMode

    public boolean reportFullscreenMode(boolean enabled)

    Description copied from interface: InputConnection
    Called by the IME to tell the client when it switches between fullscreen and normal modes. This will normally be called for you by the standard implementation of InputMethodService.

    Specified by:

    reportFullscreenMode in interface InputConnection

  • performPrivateCommand

    public boolean performPrivateCommand(String action,
                                Bundle data)

    Description copied from interface: InputConnection
    API to send private commands from an input method to its connected editor. This can be used to provide domain-specific features that are only known between certain input methods and their clients. Note that because the InputConnection protocol is asynchronous, you have no way to get a result back or know if the client understood the command; you can use the information in EditorInfo to determine if a client supports a particular command.

    Specified by:

    performPrivateCommand in interface InputConnection

    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.

    Returns:

    Returns true if the command was sent (whether or not the associated editor understood it), false if the input connection is no longer valid.