SelfContentObserver
protected open class SelfContentObserver : ContentObserver
Cursors use this class to track changes others make to their URI.
Summary
| Public methods |
| open Boolean |
Returns true if this observer is interested receiving self-change notifications.
|
| open Unit |
This method is called when a content change occurs.
|
| Inherited functions |
From class ContentObserver
Unit |
dispatchChange(selfChange: Boolean)
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.
|
Unit |
dispatchChange(selfChange: Boolean, uri: Uri?)
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.
|
Unit |
dispatchChange(selfChange: Boolean, uri: Uri?, flags: Int)
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.
|
Unit |
dispatchChange(selfChange: Boolean, uris: MutableCollection<Uri!>, flags: Int)
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.
|
Unit |
onChange(selfChange: Boolean, uri: Uri?)
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>
|
Unit |
onChange(selfChange: Boolean, uri: Uri?, flags: Int)
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.
|
Unit |
onChange(selfChange: Boolean, uris: MutableCollection<Uri!>, flags: Int)
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.
|
|
Public constructors
Public methods
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.
| Return |
Boolean |
True if self-change notifications should be delivered to the observer. |
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.
| Parameters |
selfChange |
Boolean: True if this is a self-change notification. |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2026-02-13 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-02-13 UTC."],[],[]]
![[Android Developers]](https://www.gstatic.com/devrel-devsite/prod/v0f3a5b8b76e4a120372a69044e02756e703b6140f9f1812c6e4a0407b19864b7/android/images/lockup.png){kind=link}
![[X]](https://developer.android.com/_static/android/images/logo-x.svg){kind=link}
![[YouTube]](https://www.gstatic.com/images/icons/material/product/2x/youtube_48dp.png){kind=link}
![[LinkedIn]](https://developer.android.com/_static/android/images/logo-linkedin.svg){kind=link}
![[Google Developers]](https://www.gstatic.com/devrel-devsite/prod/v0f3a5b8b76e4a120372a69044e02756e703b6140f9f1812c6e4a0407b19864b7/android/images/lockup-google-for-developers.svg){kind=link}