NSArrayController Bindings

Availability Bindings

editable

A multiple-value binding that determines if the NSArrayController is editable in the user interface.

When editable is bound, a new binding, editable2, is exposed and can be bound. Binding to editable2 causes editable3 to be exposed, and so on.

The contents of the NSArrayController are editable if a logical AND operation on all the editable bindings results in a Boolean value of YES.

Controller Content Bindings

contentArray

An indexed collection that specifies the content of the NSArrayController.

The indexed collection is an NSArray instance or subclass, a property that is accessible using the key-value-coding indexed accessor methods, or is accessible through mutableArrayValueForKey:.

You should use the contentSet binding for Core Data to-many relationships.

contentArrayForMultipleSelection

An indexed collection specifying the items that the NSArrayController treats as its content objects when the contentArray or contentObject binding returns the multiple selection marker.

The indexed collection is an NSArray instance or subclass, a property that is accessible using the key-value-coding indexed accessor methods, or is accessible through mutableArrayValueForKey:.

This binding is used when the NSArrayController displays the detail objects in a master-detail relationship, and the master NSArrayController allows multiple selection. Typically when multiple items are selected in the master controller, the detail controller bindings return the values set as the multiple values placeholder. When contentArrayForMultipleSelection is bound, the items in that array are used instead.

This binding is useful when combined with array operators. For example, contentArray is bound to the "selection.employees' keypath of companyArrayController and, contentArrayForMultipleSelection is bound to the "selection.@distinctUnionOfArrays.employees" keypath of companyArrayController. When a single company is selected in companyArrayController, the employees of that company are used as the content. When multiple companies are selected, the employees from all the selected companies are used as content.

contentObject

An NSArrayController that the NSArrayController treats as its content.

This is bound when the object is the detail controller in a master-detail configuration. The binding is typically created with the selection key path in the master array controller that represents an attribute or to-one relationship. When the master array controller's selection returns the multiple selection marker, the contentArrayForMultipleSelection binding is used as the content of the NSArrayController.

contentSet

An NSSet that specifies the content of the NSArrayController.

Controller Content Parameters Bindings

filterPredicate

The NSPredicate instance that is used by the NSArrayController to filter the array controller contents.

selectionIndexes

An NSIndexSet instance that specifies the indices of the selected rows in the NSArrayController.

sortDescriptors

An indexed collection of NSSortDescriptor instances that specify the sort ordering of the contents of the NSArrayController.

The indexed collection is an NSArray instance or subclass, or a property that is accessible using the key-value-coding indexed accessor methods.

Parameters Bindings

managedObjectContext

The NSManagedObjectContext instance that the NSArrayController is registered with.