Most visited

Recently visited

Added in API level 1

ContentObserver

public abstract class ContentObserver
extends Object

java.lang.Object
   ↳ android.database.ContentObserver
Known Direct Subclasses


接收对内容更改的回叫。 必须通过添加到ContentObservable对象来实现。

Summary

Public constructors

ContentObserver(Handler handler)

创建一个内容观察者。

Public methods

boolean deliverSelfNotifications()

如果此观察者有兴趣接收自我更改通知,则返回true。

final void dispatchChange(boolean selfChange)

此方法在API级别16中已弃用。请改为使用dispatchChange(boolean, Uri) 。

final void dispatchChange(boolean selfChange, Uri uri)

将更改通知分发给观察者。

void onChange(boolean selfChange)

内容更改时会调用此方法。

void onChange(boolean selfChange, Uri uri)

内容更改时会调用此方法。

Inherited methods

From class java.lang.Object

Public constructors

ContentObserver

Added in API level 1
ContentObserver (Handler handler)

创建一个内容观察者。

Parameters
handler Handler: The handler to run onChange(boolean) on, or null if none.

Public methods

deliverSelfNotifications

Added in API level 1
boolean deliverSelfNotifications ()

如果此观察者有兴趣接收自我更改通知,则返回true。 子类应该重写此方法以指示观察者是否有兴趣接收它对内容本身所做的更改的通知。

Returns
boolean True if self-change notifications should be delivered to the observer.

dispatchChange

Added in API level 1
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.

dispatchChange

Added in API level 16
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.

onChange

Added in API level 1
void onChange (boolean selfChange)

内容更改时会调用此方法。

子类应该重写此方法来处理内容更改。

Parameters
selfChange boolean: True if this is a self-change notification.

onChange

Added in API level 16
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.

Hooray!