ADC Home > Reference Library > Reference > Cocoa > User Experience > Cocoa Bindings Reference >

< Previous PageNext Page > Hide TOC

NSPopUpButtonCell Bindings

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

Contents:

Availability Bindings
Font Bindings
Parameters Bindings
Value Selection Bindings


Availability Bindings

editable

A multiple-value binding that determines if the NSPopUpButtonCell 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 NSPopUpButtonCell 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.3 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

enabled

A multiple-value binding that determines if the NSPopUpButtonCell is enabled in the user interface.

When enabled is bound, a new binding, enabled2, is exposed and can be bound. Binding to enabled2 causes enabled3 to be exposed, and so on.

The NSPopUpButtonCell is enabled if a logical AND operation on all the enabled bindings results in a Boolean value of YES.

Availability:
Available in Mac OS X v10.3 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

Font Bindings

font

An NSFont used to display the NSPopUpButtonCell.

If font is bound, all other Font category bindings are disabled.

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


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

fontBold

A Boolean value that determines if the NSFont used to display the NSPopUpButtonCell is bold. If fontBold evaluates to YES, the bold attribute is added to the font.

If fontBold is bound, the font and fontName bindings are disabled.

Availability:
Available in Mac OS X v10.3 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

fontFamilyName

An NSString that specifies the family name of the NSFont used to display the contents of the NSPopUpButtonCell.

If fontFamilyName is bound to a key, the font and fontName bindings are disabled.

Availability:
Available in Mac OS X v10.3 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

fontItalic

A Boolean value that determines if the NSFont used to display the NSPopUpButtonCell is italic. If fontItalic evaluates to YES, the italic attribute is added to the font.

If fontItalic is bound, the font and fontName bindings are disabled.

Availability:
Available in Mac OS X v10.3 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

fontName

An NSString that specifies the full name of the NSFont that is used to display the contents of the NSPopUpButtonCell. The full font name includes the family and the style of the font — for example, "Helvetica-Bold".

If fontName bound to a key, the font, fontBold, fontFamilyName and fontItalic bindings are disabled.

Availability:
Available in Mac OS X v10.3 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

fontSize

An integer value that determines the size, in points, of the font used to display the NSPopUpButtonCell.

If fontSize is bound, the font binding is disabled.

Availability:
Available in Mac OS X v10.3 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
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSNumber
Null PlaceholderNSNullPlaceholderBindingOptionNSNumber

Parameters Bindings

mixedStateImage

An NSImage that is displayed when the value of the NSMenuItem is NSMixedState.

The default image is an en dash.

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


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

offStateImage

An NSImage that is displayed when the value of the NSMenuItem is NSOffState.

The default is an empty image.

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


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

onStateImage

An NSImage that is displayed when the value of the NSMenuItem is NSOnStatem.

The default image is a checkmark.

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


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

Value Selection Bindings

content

An NSArrayController instance that provides the content of the NSPopUpButtonCell.

Unless contentValues is also bound, the titles of the items in the NSPopUpButtonCell are derived by invoking description for each of the content objects.

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


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


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

contentObjects

An array of objects that are returned by selectedObject or selectedObjects in place of the corresponding content object.

If content is not bound, the contentObjects binding is not available.

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


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

contentValues

An array of strings that are displayed as the items in the NSPopUpButtonCell.

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


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


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

selectedIndex

An integer value that specifies the index of the selected item in the NSPopUpButtonCell. When the selection changes in the NSPopUpButtonCell, this value is updated with the index of the newly selected item.

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


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOptionNSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSNumber
Null PlaceholderNSNullPlaceholderBindingOptionNSNumber

selectedObject

An object that specifies the item that is selected in the NSPopUpButtonCell. This is the object in the content that corresponds to the currently selected item.

The selectedObject binding is only available when the content binding is bound.

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


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

selectedTag

An integer value that specifies the tag of the selected item in the NSPopUpButtonCell. When the selection changes in the NSPopUpButtonCell, this value is updated with the tag of the newly selected item.

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


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOptionNSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOptionNSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOptionNSNumber
Null PlaceholderNSNullPlaceholderBindingOptionNSNumber

selectedValue

An NSString that specifies the title of the selected item in the NSPopUpButtonCell.

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


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


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


< 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.