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

FocusFinder

extends Object
java.lang.Object
   ↳ android.view.FocusFinder

Class Overview

The algorithm used for finding the next focusable view in a given direction from a view that currently has focus.

Summary

Public Methods
View findNearestTouchable ( ViewGroup root, int x, int y, int direction, int[] deltas)
Find the nearest touchable view to the specified view.
final View findNextFocus ( ViewGroup root, View focused, int direction)
Find the next view to take focus in root's descendants, starting from the view that currently is focused.
View findNextFocusFromRect ( ViewGroup root, Rect focusedRect, int direction)
Find the next view to take focus in root's descendants, searching from a particular rectangle in root's coordinates.
static FocusFinder getInstance ()
Get the focus finder for this thread.
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

public View findNearestTouchable ( ViewGroup root, int x, int y, int direction, int[] deltas)

Added in API level 1

Find the nearest touchable view to the specified view.

Parameters
root The root of the tree in which to search
x X coordinate from which to start the search
y Y coordinate from which to start the search
direction Direction to look
deltas Offset from the to the edge of the nearest view. Note that this array may already be populated with values.
Returns
  • The nearest touchable view, or null if none exists.

public final View findNextFocus ( ViewGroup root, View focused, int direction)

Added in API level 1

Find the next view to take focus in root's descendants, starting from the view that currently is focused.

Parameters
root Contains focused. Cannot be null.
focused Has focus now.
direction Direction to look.
Returns
  • The next focusable view, or null if none exists.

public View findNextFocusFromRect ( ViewGroup root, Rect focusedRect, int direction)

Added in API level 1

Find the next view to take focus in root's descendants, searching from a particular rectangle in root's coordinates.

Parameters
root Contains focusedRect. Cannot be null.
focusedRect The starting point of the search.
direction Direction to look.
Returns
  • The next focusable view, or null if none exists.

public static FocusFinder getInstance ()

Added in API level 1

Get the focus finder for this thread.