< Previous PageNext Page > Hide TOC

NSDictionaryController Bindings

Related class
Availability
Available in Mac OS X v10.5 and later.

Contents:

Availability Bindings
Controller Content Bindings
Controller Content Parameters Bindings
Parameters Bindings


Availability Bindings

editable

A multiple-value binding that determines if the NSDictionaryController 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 NSDictionaryController are editable if a logical AND operation on all the editable bindings results in a Boolean value of YES.

Availability:
Available in Mac OS X v10.5 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOptionNSNumber (Boolean) or NSNull
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSNumber (Boolean) or NSNull
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSNumber (Boolean) or NSNull
Null PlaceholderNSNullPlaceholderBindingOptionNSNumber (Boolean) or NSNull

Controller Content Bindings

contentDictionary

An NSDictionary object that specifies the content of the NSDictionaryController.

Availability:
Available in Mac OS X v10.5 and later.


Binding Options
OptionBinding option constantValue class
Always Presents Application Modal Alerts. Available in Mac OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOptionNSNumber (Boolean)
Conditionally Sets EditableNSConditionallySetsEditableBindingOptionNSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOptionNSNumber (Boolean)

Controller Content Parameters Bindings

filterPredicate

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

Availability:
Available in Mac OS X v10.5 and later.


Binding Options
OptionBinding option constantValue class
Always Presents Application Modal Alerts. Available in Mac OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOptionNSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOptionNSNumber (Boolean)

selectionIndexes

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

Typically, selectionIndexes is bound automatically to the NSArrayController that the first NSTableColumn is bound to.

Availability:
Available in Mac OS X v10.5 and later.


Binding Options
OptionBinding option constantValue class
Always Presents Application Modal Alerts. Available in Mac OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOptionNSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOptionNSNumber (Boolean)

sortDescriptors

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

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

Typically this binding is created automatically, binding to the sort descriptors of the NSArrayController of the initially bound NSTableColumn.

Availability:
Available in Mac OS X v10.5 and later.


Binding Options
OptionBinding option constantValue class
Always Presents Application Modal Alerts. Available in Mac OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOptionNSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOptionNSNumber (Boolean)

Parameters Bindings

excludedKeys

An array of strings containing the names of the keys in the dictionary content that should never be displayed in the user interface.

Availability:
Available in Mac OS X v10.5 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)

includedKeys

An array of strings containing the names of the keys in the contentDictionary that should always be displayed in the user interface, even if they are not present in the contentDictionary.

Availability:
Available in Mac OS X v10.5 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)

initialKey

A string used as the initial key name for a newly inserted item in the contentDictionary.

As new items are inserted the controller enumerates the initial key name, resulting in key names such as “key”, “key1”, “key2”, and so on. This behavior can be customized by overriding newObject.

Availability:
Available in Mac OS X v10.5 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOptionNSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSString
Null PlaceholderNSNullPlaceholderBindingOptionNSString

initialValue

A string used as the initial value for a newly inserted item in the contentDictionary.

Availability:
Available in Mac OS X v10.5 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)

localizedKeyDictionary

An NSDictionary that provides the localized key names for the keys in the dictionary, allowing a user-friendly representation of the key name to be displayed.

Availability:
Available in Mac OS X v10.5 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)

managedObjectContext

The NSManagedObjectContext instance that the NSDictionaryController is registered with.

Availability:
Available in Mac OS X v10.5 and later.
Binding is Read-Only.


Binding Options
OptionBinding option constantValue class
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOptionNSNumber (Boolean)



< Previous PageNext Page > Hide TOC


© 2004, 2007 Apple Inc. All Rights Reserved. (Last updated: 2007-10-31)


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.