NSButtonCell Bindings

Action Invocation Bindings

argument

A multiple-value binding that specifies the object passed as a parameter to the selector.

When argument is bound, a new binding, argument2, is exposed and can be bound. Binding to argument2 causes argument3 to be exposed, and so on.

The objects specified in the argument bindings are passed as parameters to the selector specified in the target binding when the NSButtonCell is clicked.

target

An object that receives a message corresponding to selector name when the NSButtonCell is clicked.

Availability Bindings

editable

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

enabled

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

Font Bindings

font

An NSFont used to display the NSButtonCell.

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

fontBold

A Boolean value that determines if the NSFont used to display the NSButtonCell 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.

fontFamilyName

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

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

fontItalic

A Boolean value that determines if the NSFont used to display the NSButtonCell 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.

fontName

An NSString that specifies the full name of the NSFont that is used to display the contents of the NSButtonCell. 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.

fontSize

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

If fontSize is bound, the font binding is disabled.

Parameters Bindings

alternateImage

An NSImage that is displayed by the NSButtonCell when it is in its alternate state. Note that some button types don't display an alternate image.

alternateTitle

An NSString that is displayed by the NSButtonCell when it is in its alternate state. Note that some button types don't display an alternate title.

image

An NSImage that specifies the image displayed by the NSButtonCell.

title

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

Value Bindings

value

An integer value that specifies the current state of the NSButtonCell.

If the value binding represents a multiple value selection, and both YES and NO values are represented in the bound key, the button is temporarily set to allow mixed states if it doesn't already. If the button is already configured to allow mixed states, the setting is unchanged.