Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public class

BaseMovementMethod

extends Object
implements MovementMethod
java.lang.Object
   ↳ android.text.method.BaseMovementMethod
Known Direct Subclasses
Known Indirect Subclasses

Class Overview

Base classes for movement methods.

Summary

Public Constructors
BaseMovementMethod ()
Public Methods
boolean canSelectArbitrarily ()
Returns true if this movement method allows arbitrary selection of any text; false if it has no selection (like a movement method that only scrolls) or a constrained selection (for example limited to links.
void initialize ( TextView widget, Spannable text)
boolean onGenericMotionEvent ( TextView widget, Spannable text, MotionEvent event)
boolean onKeyDown ( TextView widget, Spannable text, int keyCode, KeyEvent event)
boolean onKeyOther ( TextView widget, Spannable text, KeyEvent event)
If the key listener wants to other kinds of key events, return true, otherwise return false and the caller (i.e.
boolean onKeyUp ( TextView widget, Spannable text, int keyCode, KeyEvent event)
void onTakeFocus ( TextView widget, Spannable text, int direction)
boolean onTouchEvent ( TextView widget, Spannable text, MotionEvent event)
boolean onTrackballEvent ( TextView widget, Spannable text, MotionEvent event)
Protected Methods
boolean bottom ( TextView widget, Spannable buffer)
Performs a bottom movement action.
boolean down ( TextView widget, Spannable buffer)
Performs a down movement action.
boolean end ( TextView widget, Spannable buffer)
Performs an end movement action.
int getMovementMetaState ( Spannable buffer, KeyEvent event)
Gets the meta state used for movement using the modifiers tracked by the text buffer as well as those present in the key event.
boolean handleMovementKey ( TextView widget, Spannable buffer, int keyCode, int movementMetaState, KeyEvent event)
Performs a movement key action.
boolean home ( TextView widget, Spannable buffer)
Performs a home movement action.
boolean left ( TextView widget, Spannable buffer)
Performs a left movement action.
boolean lineEnd ( TextView widget, Spannable buffer)
Performs a line-end movement action.
boolean lineStart ( TextView widget, Spannable buffer)
Performs a line-start movement action.
boolean pageDown ( TextView widget, Spannable buffer)
Performs a page-down movement action.
boolean pageUp ( TextView widget, Spannable buffer)
Performs a page-up movement action.
boolean right ( TextView widget, Spannable buffer)
Performs a right movement action.
boolean top ( TextView widget, Spannable buffer)
Performs a top movement action.
boolean up ( TextView widget, Spannable buffer)
Performs an up movement action.
[Expand]
Inherited Methods
From class java.lang.Object
From interface android.text.method.MovementMethod

Public Constructors

public BaseMovementMethod ()

Public Methods

public boolean canSelectArbitrarily ()

Added in API level 1

Returns true if this movement method allows arbitrary selection of any text; false if it has no selection (like a movement method that only scrolls) or a constrained selection (for example limited to links. The "Select All" menu item is disabled if arbitrary selection is not allowed.

public void initialize ( TextView widget, Spannable text)

Added in API level 1

public boolean onGenericMotionEvent ( TextView widget, Spannable text, MotionEvent event)

public boolean onKeyDown ( TextView widget, Spannable text, int keyCode, KeyEvent event)

Added in API level 1

public boolean onKeyOther ( TextView widget, Spannable text, KeyEvent event)

Added in API level 3

If the key listener wants to other kinds of key events, return true, otherwise return false and the caller (i.e. the widget host) will handle the key.

public boolean onKeyUp ( TextView widget, Spannable text, int keyCode, KeyEvent event)

Added in API level 1

public void onTakeFocus ( TextView widget, Spannable text, int direction)

public boolean onTouchEvent ( TextView widget, Spannable text, MotionEvent event)

public boolean onTrackballEvent ( TextView widget, Spannable text, MotionEvent event)

Added in API level 1

Protected Methods

protected boolean bottom ( TextView widget, Spannable buffer)

Performs a bottom movement action. Moves the cursor or scrolls to the bottom of the buffer.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.

protected boolean down ( TextView widget, Spannable buffer)

Performs a down movement action. Moves the cursor or scrolls down by one line.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.

protected boolean end ( TextView widget, Spannable buffer)

Performs an end movement action. Moves the cursor or scrolls to the start of the line or to the top of the document depending on whether the insertion point is being moved or the document is being scrolled.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.

protected int getMovementMetaState ( Spannable buffer, KeyEvent event)

Gets the meta state used for movement using the modifiers tracked by the text buffer as well as those present in the key event. The movement meta state excludes the state of locked modifiers or the SHIFT key since they are not used by movement actions (but they may be used for selection).

Parameters
buffer The text buffer.
event The key event.
Returns
  • The keyboard meta states used for movement.

protected boolean handleMovementKey ( TextView widget, Spannable buffer, int keyCode, int movementMetaState, KeyEvent event)

Performs a movement key action. The default implementation decodes the key down and invokes movement actions such as down(TextView, Spannable) and up(TextView, Spannable) . onKeyDown(TextView, Spannable, int, KeyEvent) calls this method once to handle an ACTION_DOWN . onKeyOther(TextView, Spannable, KeyEvent) calls this method repeatedly to handle each repetition of an ACTION_MULTIPLE .

Parameters
widget The text view.
buffer The text buffer.
keyCode The key code.
movementMetaState The keyboard meta states used for movement.
event The key event.
Returns
  • True if the event was handled.

protected boolean home ( TextView widget, Spannable buffer)

Performs a home movement action. Moves the cursor or scrolls to the start of the line or to the top of the document depending on whether the insertion point is being moved or the document is being scrolled.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.

protected boolean left ( TextView widget, Spannable buffer)

Performs a left movement action. Moves the cursor or scrolls left by one character.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.

protected boolean lineEnd ( TextView widget, Spannable buffer)

Performs a line-end movement action. Moves the cursor or scrolls to the end of the line.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.

protected boolean lineStart ( TextView widget, Spannable buffer)

Performs a line-start movement action. Moves the cursor or scrolls to the start of the line.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.

protected boolean pageDown ( TextView widget, Spannable buffer)

Performs a page-down movement action. Moves the cursor or scrolls down by one page.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.

protected boolean pageUp ( TextView widget, Spannable buffer)

Performs a page-up movement action. Moves the cursor or scrolls up by one page.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.

protected boolean right ( TextView widget, Spannable buffer)

Performs a right movement action. Moves the cursor or scrolls right by one character.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.

protected boolean top ( TextView widget, Spannable buffer)

Performs a top movement action. Moves the cursor or scrolls to the top of the buffer.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.

protected boolean up ( TextView widget, Spannable buffer)

Performs an up movement action. Moves the cursor or scrolls up by one line.

Parameters
widget The text view.
buffer The text buffer.
Returns
  • True if the event was handled.