NSPopUpButton Bindings

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

Availability Bindings

enabled

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

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


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSNumber (Boolean) or NSNull
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSNumber (Boolean) or NSNull
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSNumber (Boolean) or NSNull
Null PlaceholderNSNullPlaceholderBindingOption NSNumber (Boolean) or NSNull

hidden

A multiple-value binding that determines if the NSPopUpButton is displayed in the user interface.

When hidden is bound, a new binding, hidden2, is exposed and can be bound. Binding to hidden2 causes hidden3 to be exposed, and so on.

The NSPopUpButton is hidden if a logical OR operation on all the hidden bindings results in a Boolean value of YES.

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


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSNumber (Boolean) or NSNull
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSNumber (Boolean) or NSNull
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSNumber (Boolean) or NSNull
Null PlaceholderNSNullPlaceholderBindingOption NSNumber (Boolean) or NSNull

Font Bindings

font

An NSFont used to display the NSPopUpButton.

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

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


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

fontBold

A Boolean value that determines if the NSFont used to display the NSPopUpButton 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 OS X v10.3 and later.
Binding is Read-Only.


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSNumber (Boolean) or NSNull
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSNumber (Boolean) or NSNull
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSNumber (Boolean) or NSNull
Null PlaceholderNSNullPlaceholderBindingOption NSNumber (Boolean) or NSNull

fontFamilyName

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

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

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


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSString
Null PlaceholderNSNullPlaceholderBindingOption NSString

fontItalic

A Boolean value that determines if the NSFont used to display the NSPopUpButton 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 OS X v10.3 and later.
Binding is Read-Only.


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSNumber (Boolean) or NSNull
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSNumber (Boolean) or NSNull
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSNumber (Boolean) or NSNull
Null PlaceholderNSNullPlaceholderBindingOption NSNumber (Boolean) or NSNull

fontName

An NSString that specifies the full name of the NSFont that is used to display the contents of the NSPopUpButton. 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 OS X v10.3 and later.
Binding is Read-Only.


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSString
Null PlaceholderNSNullPlaceholderBindingOption NSString

fontSize

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

If fontSize is bound, the font binding is disabled.

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


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSNumber
Null PlaceholderNSNullPlaceholderBindingOption NSNumber

Parameters Bindings

toolTip

An NSString that contains the tool tip to display for this NSPopUpButton.

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


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


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSString
Null PlaceholderNSNullPlaceholderBindingOption NSString

Value Selection Bindings

content

An NSArrayController instance that provides the content of the NSPopUpButton.

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

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


Binding Options
OptionBinding option constantValue class
Specifies the tag id of the popup menu item to replace with the content of the array. Available in OS X v10.5 and later.NSContentPlacementTagBindingOption NSNumber
Inserts Null PlaceholderNSInsertsNullPlaceholderBindingOption NSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSString
Null PlaceholderNSNullPlaceholderBindingOption NSString

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 OS X v10.4 and later.


Binding Options
OptionBinding option constantValue class
Specifies the tag id of the popup menu item to replace with the content of the array. Available in OS X v10.5 and later.NSContentPlacementTagBindingOption NSNumber
Inserts Null PlaceholderNSInsertsNullPlaceholderBindingOption NSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)

contentValues

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

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


Binding Options
OptionBinding option constantValue class
Inserts Null PlaceholderNSInsertsNullPlaceholderBindingOption NSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)
Specifies the tag id of the popup menu item to replace with the content of the array. Available in OS X v10.5 and later.NSContentPlacementTagBindingOption NSNumber


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSString
Null PlaceholderNSNullPlaceholderBindingOption NSString

selectedIndex

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

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


Binding Options
OptionBinding option constantValue class
Allows Editing Multiple Value SelectionNSAllowsEditingMultipleValuesSelectionBindingOption NSNumber (Boolean)
Always Presents Application Modal Alerts. Available in OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOption NSNumber (Boolean)
Conditionally Sets EnabledNSConditionallySetsEnabledBindingOption NSNumber (Boolean)
Conditionally Sets HiddenNSConditionallySetsHiddenBindingOption NSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOption NSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSNumber
Null PlaceholderNSNullPlaceholderBindingOption NSNumber

selectedObject

An object that specifies the item that is selected in the NSPopUpButton. 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 OS X v10.3 and later.


Binding Options
OptionBinding option constantValue class
Allows Editing Multiple Value SelectionNSAllowsEditingMultipleValuesSelectionBindingOption NSNumber (Boolean)
Always Presents Application Modal Alerts. Available in OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOption NSNumber (Boolean)
Conditionally Sets EnabledNSConditionallySetsEnabledBindingOption NSNumber (Boolean)
Conditionally Sets HiddenNSConditionallySetsHiddenBindingOption NSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOption NSNumber (Boolean)

selectedTag

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

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


Binding Options
OptionBinding option constantValue class
Allows Editing Multiple Value SelectionNSAllowsEditingMultipleValuesSelectionBindingOption NSNumber (Boolean)
Always Presents Application Modal Alerts. Available in OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOption NSNumber (Boolean)
Conditionally Sets EnabledNSConditionallySetsEnabledBindingOption NSNumber (Boolean)
Conditionally Sets HiddenNSConditionallySetsHiddenBindingOption NSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOption NSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSNumber
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSNumber
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSNumber
Null PlaceholderNSNullPlaceholderBindingOption NSNumber

selectedValue

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

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


Binding Options
OptionBinding option constantValue class
Allows Editing Multiple Value SelectionNSAllowsEditingMultipleValuesSelectionBindingOption NSNumber (Boolean)
Always Presents Application Modal Alerts. Available in OS X v10.4 and later.NSAlwaysPresentsApplicationModalAlertsBindingOption NSNumber (Boolean)
Conditionally Sets EnabledNSConditionallySetsEnabledBindingOption NSNumber (Boolean)
Conditionally Sets HiddenNSConditionallySetsHiddenBindingOption NSNumber (Boolean)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOption NSNumber (Boolean)


Placeholders
DescriptionPlaceholder constantValue class
Multiple Values PlaceholderNSMultipleValuesPlaceholderBindingOption NSString
No Selection PlaceholderNSNoSelectionPlaceholderBindingOption NSString
Not Applicable PlaceholderNSNotApplicablePlaceholderBindingOption NSString
Null PlaceholderNSNullPlaceholderBindingOption NSString