public abstract class ContentObserver
extends Object
java.lang.Object | |
↳ | android.database.ContentObserver |
Known Direct Subclasses |
接收对内容更改的回叫。 必须通过添加到ContentObservable
对象来实现。
Public constructors |
|
---|---|
ContentObserver(Handler handler) 创建一个内容观察者。 |
Public methods |
|
---|---|
boolean |
deliverSelfNotifications() 如果此观察者有兴趣接收自我更改通知,则返回true。 |
final void |
dispatchChange(boolean selfChange) 此方法在API级别16中已弃用。请改为使用 |
final void |
dispatchChange(boolean selfChange, Uri uri) 将更改通知分发给观察者。 |
void |
onChange(boolean selfChange) 内容更改时会调用此方法。 |
void |
onChange(boolean selfChange, Uri uri) 内容更改时会调用此方法。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
ContentObserver (Handler handler)
创建一个内容观察者。
Parameters | |
---|---|
handler |
Handler : The handler to run onChange(boolean) on, or null if none. |
boolean deliverSelfNotifications ()
如果此观察者有兴趣接收自我更改通知,则返回true。 子类应该重写此方法以指示观察者是否有兴趣接收它对内容本身所做的更改的通知。
Returns | |
---|---|
boolean |
True if self-change notifications should be delivered to the observer. |
void dispatchChange (boolean selfChange)
此方法在API级别16中已被弃用。
改为使用dispatchChange(boolean, Uri)
。
将更改通知分发给观察者。
如果为Handler
构造函数提供了ContentObserver
,则将对onChange(boolean)
方法的调用发送到处理程序的消息队列。 否则,该线程立即调用onChange(boolean)
方法。
Parameters | |
---|---|
selfChange |
boolean : True if this is a self-change notification. |
void dispatchChange (boolean selfChange, Uri uri)
将更改通知分发给观察者。 在可用时包含已更改的内容Uri。
如果为Handler
构造函数提供了ContentObserver
,则将对onChange(boolean)
方法的调用发送到处理程序的消息队列。 否则,该线程立即调用onChange(boolean)
方法。
Parameters | |
---|---|
selfChange |
boolean : True if this is a self-change notification. |
uri |
Uri : The Uri of the changed content, or null if unknown. |
void onChange (boolean selfChange)
内容更改时会调用此方法。
子类应该重写此方法来处理内容更改。
Parameters | |
---|---|
selfChange |
boolean : True if this is a self-change notification. |
void onChange (boolean selfChange, Uri uri)
内容更改时会调用此方法。 在可用时包含已更改的内容Uri。
子类应该重写此方法来处理内容更改。 为了确保在没有提供Uri参数的旧版本框架上正确运行,应用程序在实现onChange(boolean)
过载时也应实现此方法的onChange(boolean, Uri)
重载。
示例实现:
// Implement the onChange(boolean) method to delegate the change notification to
// the onChange(boolean, Uri) method to ensure correct operation on older versions
// of the framework that did not have the onChange(boolean, Uri) method.
@Override
public void onChange(boolean selfChange) {
onChange(selfChange, null);
}
// Implement the onChange(boolean, Uri) method to take advantage of the new Uri argument.
@Override
public void onChange(boolean selfChange, Uri uri) {
// Handle change.
}
Parameters | |
---|---|
selfChange |
boolean : True if this is a self-change notification. |
uri |
Uri : The Uri of the changed content, or null if unknown. |