Controller Key-Value Observing Compliance

The Cocoa bindings controller classes only provide key-value observing notifications for selected properties. This article enumerates the key-value-observing compliant properties for each class.

Important: The Cocoa bindings controller classes do not provide change values when sending key-value observing notifications to observers. It is the developer’s responsibility to query the controller to determine the new values.

NSUserDefaultsController

NSUserDefaultsController is key-value-observing compliant for the following properties:

appliesImmediately
defaults
hasUnappliedChanges
initialValues
values

NSObjectController

NSObjectController is key-value-observing compliant for the following properties:

canAdd
canRemove
content
isEditable
objectClass
selectedObjects
selection

NSArrayController

NSArrayController is key-value-observing compliant for the following properties:

alwaysUsesMultipleValuesMarker
arrangedObjects
avoidsEmptySelection
canAdd
canInsert
canRemove
canSelectNext
canSelectPrevious
clearsFilterPredicateOnInsertion
content
filterPredicate
isEditable
preservesSelection
selectedObjects
selection
selectionIndex
selectionIndexes
selectsInsertedObjects
sortDescriptors

NSTreeController

NSTreeController is key-value-observing compliant for the following properties:

alwaysUsesMultipleValuesMarker
arrangedObjects
avoidsEmptySelection
canAdd
canAddChild
canInsert
canInsertChild
canRemove
canSelectNext
canSelectPrevious
content
isEditable
preservesSelection
selectedObjects
selection
selectionIndexPath
selectionIndexPaths
selectsInsertedObjects
sortDescriptors

Note: The value returned by NSTreeController's arrangedObjects method is opaque. You should only observe this property to determine that a change has occurred.

< Previous PageNext Page >

Hide TOC

Did this document help you?
Yes: Tell us what works for you. It’s good, but: Report typos, inaccuracies, and so forth. It wasn’t helpful: Tell us what would have helped.