summaryrefslogtreecommitdiff
path: root/core/java
diff options
context:
space:
mode:
authorSvetoslav Ganov <svetoslavganov@google.com>2012-02-01 17:01:12 -0800
committerSvetoslav Ganov <svetoslavganov@google.com>2012-02-01 17:01:12 -0800
commit13fd561848ec43573d4cfeec899b4d308841c251 (patch)
treef5d93497260906fadbaeae0304a22404e90a5a25 /core/java
parent064d2d65697ecd95c72e2724cf066f8ad162d240 (diff)
Update the comment for View#clearFocus
Change-Id: I779f94e88821574c74e5e76d99ae555a47042c12
Diffstat (limited to 'core/java')
-rw-r--r--core/java/android/view/View.java10
1 files changed, 8 insertions, 2 deletions
diff --git a/core/java/android/view/View.java b/core/java/android/view/View.java
index d80d0801f2c9..cf4cff92c841 100644
--- a/core/java/android/view/View.java
+++ b/core/java/android/view/View.java
@@ -3761,8 +3761,14 @@ public class View implements Drawable.Callback, Drawable.Callback2, KeyEvent.Cal
}
/**
- * Called when this view wants to give up focus. This will cause
- * {@link #onFocusChanged(boolean, int, android.graphics.Rect)} to be called.
+ * Called when this view wants to give up focus. If focus is cleared
+ * {@link #onFocusChanged(boolean, int, android.graphics.Rect)} is called.
+ * <p>
+ * <strong>Note:</strong> When a View clears focus the framework is trying
+ * to give focus to the first focusable View from the top. Hence, if this
+ * View is the first from the top that can take focus, then its focus will
+ * not be cleared nor will the focus change callback be invoked.
+ * </p>
*/
public void clearFocus() {
if (DBG) {