NSButton 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 NSButton is clicked.

target

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

Availability Bindings

enabled

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

hidden

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

Font Bindings

font

An NSFont used to display the NSButton.

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

fontBold

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

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

If fontSize is bound, the font binding is disabled.

Parameters Bindings

alternateImage

An NSImage that is displayed by the NSButton 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 NSButton 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 NSButton.

title

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

toolTip

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

Value Bindings

value

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

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.