Instance Property


The button’s key-equivalent character.


@property(copy) NSString *keyEquivalent;


The value of this property is the string that contains the key equivalent character of the button, or the empty string if one hasn't been defined. Buttons don't have a default key equivalent.

Setting this property redraws the button’s inside if it displays a key equivalent instead of an image. The key equivalent isn’t displayed if the image position is set to NSNoImage, NSImageOnly, or NSImageOverlaps; that is, the button must display both its title and its “image” (the key equivalent in this case), and they must not overlap.

To display a key equivalent on a button, set the image and alternate image to nil, then set the key equivalent, then set the image position.

See Also

Managing the Key Equivalent


The font used to draw the button’s key equivalent.


The mask that identifies the modifier keys for the button's key equivalent.

- setKeyEquivalentFont:size:

Sets by name and size of the font used to draw the key equivalent.