NSMenuItem Bindings

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

Availability Bindings

enabled

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

Parameters Bindings

image

An NSImage that specifies the image displayed by the NSMenuItem.

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)

mixedStateImage

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

The default image is an en dash.

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)

offStateImage

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

The default is an empty image.

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)

onStateImage

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

The default image is a checkmark.

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)

title

An NSString value that is displayed as the label of the NSMenuItem.

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

Value Bindings

value

An integer value that specifies the state of the NSMenuItem.

If value evaluates to 0 (NSOffState) or nil, the off state image is displayed; the default is an empty image. If value evaluates to 1 (NSOnState), the on state image is displayed; the default is a checkmark. If value evaluates to -1 (NSMixedState), the mixed state image is displayed, the default is an en dash.

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)
Raises for Not Applicable KeysNSRaisesForNotApplicableKeysBindingOption NSNumber (Boolean)
Validates ImmediatelyNSValidatesImmediatelyBindingOption NSNumber (Boolean)