From f5d412a0c707bfc3a5e27cdaaea8b2a4e8cb5d72 Mon Sep 17 00:00:00 2001 From: Adam Powell Date: Tue, 27 Sep 2011 11:32:59 -0700 Subject: Improve docs in BaseAdapter. Change-Id: Idbe19f9b01132c28b4960515c23bd28e3729fd5d --- core/java/android/widget/BaseAdapter.java | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/core/java/android/widget/BaseAdapter.java b/core/java/android/widget/BaseAdapter.java index 532fd766ec66..401fcb83499d 100644 --- a/core/java/android/widget/BaseAdapter.java +++ b/core/java/android/widget/BaseAdapter.java @@ -43,13 +43,18 @@ public abstract class BaseAdapter implements ListAdapter, SpinnerAdapter { } /** - * Notifies the attached View that the underlying data has been changed - * and it should refresh itself. + * Notifies the attached observers that the underlying data has been changed + * and any View reflecting the data set should refresh itself. */ public void notifyDataSetChanged() { mDataSetObservable.notifyChanged(); } - + + /** + * Notifies the attached observers that the underlying data is no longer valid + * or available. Once invoked this adapter is no longer valid and should + * not report further data set changes. + */ public void notifyDataSetInvalidated() { mDataSetObservable.notifyInvalidated(); } -- cgit v1.2.3-59-g8ed1b