ContentObserver

ContentObserver

ContentObserver(handler: Handler!)

Creates a content observer.

deliverSelfNotifications

open fun deliverSelfNotifications(): Boolean

Returns true if this observer is interested receiving self-change notifications. Subclasses should override this method to indicate whether the observer is interested in receiving notifications for changes that it made to the content itself.

dispatchChange

fun dispatchChange(selfChange: Boolean): Unit

Deprecated: Callers should migrate towards using a richer overload that provides more details about the change, such as dispatchChange(boolean,java.util.Collection,int).

Dispatches a change notification to the observer.

If a Handler was supplied to the ContentObserver constructor, then a call to the #onChange method is posted to the handler's message queue. Otherwise, the #onChange method is invoked immediately on this thread.

dispatchChange

fun dispatchChange(
    selfChange: Boolean, 
    uri: Uri?
): Unit

Dispatches a change notification to the observer. Includes the changed content Uri when available.

If a Handler was supplied to the ContentObserver constructor, then a call to the #onChange method is posted to the handler's message queue. Otherwise, the #onChange method is invoked immediately on this thread.

dispatchChange

fun dispatchChange(
    selfChange: Boolean, 
    uri: Uri?, 
    flags: Int
): Unit

Dispatches a change notification to the observer. Includes the changed content Uri when available.

If a Handler was supplied to the ContentObserver constructor, then a call to the #onChange method is posted to the handler's message queue. Otherwise, the #onChange method is invoked immediately on this thread.

dispatchChange

fun dispatchChange(
    selfChange: Boolean, 
    uris: MutableCollection<Uri!>, 
    flags: Int
): Unit

Dispatches a change notification to the observer. Includes the changed content Uris when available.

If a Handler was supplied to the ContentObserver constructor, then a call to the #onChange method is posted to the handler's message queue. Otherwise, the #onChange method is invoked immediately on this thread.

onChange

open fun onChange(selfChange: Boolean): Unit

This method is called when a content change occurs.

Subclasses should override this method to handle content changes.

onChange

open fun onChange(
    selfChange: Boolean, 
    uri: Uri?
): Unit

This method is called when a content change occurs. Includes the changed content Uri when available.

Subclasses should override this method to handle content changes. To ensure correct operation on older versions of the framework that did not provide richer arguments, applications should implement all overloads.

Example implementation:

<code>
  // 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.
  }
  </code>

onChange

open fun onChange(
    selfChange: Boolean, 
    uri: Uri?, 
    flags: Int
): Unit

This method is called when a content change occurs. Includes the changed content Uri when available.

Subclasses should override this method to handle content changes. To ensure correct operation on older versions of the framework that did not provide richer arguments, applications should implement all overloads.

onChange

open fun onChange(
    selfChange: Boolean, 
    uris: MutableCollection<Uri!>, 
    flags: Int
): Unit

This method is called when a content change occurs. Includes the changed content Uris when available.

Subclasses should override this method to handle content changes. To ensure correct operation on older versions of the framework that did not provide richer arguments, applications should implement all overloads.