# NSButtonCell

scottc@net-community.com
far@ix.netcom.com
Generated at 2026-02-17 21:02:56 +0000

The button cell class

1996-1999 Free Software Foundation, Inc.
Software documentation for the NSButtonCell class
AppKit/NSButtonCell.h

TODO Description

Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
alternateImage

Returns the NSButtonCell's alternate image.

See Also: -setAlternateImage:

alternateMnemonic
Description forthcoming.
alternateMnemonicLocation
Description forthcoming.
alternateTitle

Returns the NSButtonCell's alternate title (used when highlighted).

See Also: -setAlternateTitle:

attributedAlternateTitle
Description forthcoming.
attributedTitle
Description forthcoming.
backgroundColor
Description forthcoming.
bezelStyle
Description forthcoming.
drawBezelWithFrame:
cellFrame
inView:
controlView
Description forthcoming.
drawImage:
imageToDisplay
withFrame:
cellFrame
inView:
controlView
Description forthcoming.
drawTitle:
titleToDisplay
withFrame:
cellFrame
inView:
controlView
Description forthcoming.
getPeriodicDelay:
delay
interval:
interval

Gets the NSButtonCell's delay and the interval parameters used when NSButton sends continouly action messages. By default delay is 0.4 and interval is 0.075.

See Also: -setPeriodicDelay:interval: [NSCell -trackMouse:inRect:ofView:untilMouseUp:]

gradientType
Description forthcoming.
highlightsBy

Returns a mask describing how the button cell is highlighted :

NSNoCellMask, NSContentsCellMask,NSPushInCellMask,NSChangeGrayCellMask, NSChangeBackgroundCellMask

See Also : -setHighlightsBy:

imageDimsWhenDisabled
Description forthcoming.
imagePosition

Returns the NSButtonCell's image position. See NSCellImagePosition for more information.

See Also: -setImagePosition:

imageScaling
Description forthcoming.
isTransparent

Returns whether the button cell is transparent.

See Also: -setTransparent:

keyEquivalent

Returns the NSButtonCell's key equivalent. The key equivalent and its modifier mask are used to simulate the click of the button in [NSButton -performKeyEquivalent:]. Returns an empty string if no key equivalent is defined. By default NSButtonCell hasn't key equivalent.

See Also: -setKeyEquivalent: [NSButton -performKeyEquivalent:] -keyEquivalentModifierMask [NSButtonCell -keyEquivalent]

keyEquivalentFont

Returns the NSFont of the key equivalent.

See Also: -setKeyEquivalentFont:

keyEquivalentModifierMask

Returns the modifier mask of the NSButtonCell's key equivalent. The key equivalent and its modifier mask are used to simulate the click of the button in [NSButton -performKeyEquivalent:]. The default mask is 0.

See Also: -setKeyEquivalentModifierMask: -keyEquivalent [NSButton -performKeyEquivalent:]

mouseEntered:
event
Description forthcoming.
mouseExited:
event
Description forthcoming.
setAlternateImage:
anImage

Sets the NSButtonCell's alternate image to anImage.

See Also: -alternateImage

setAlternateMnemonicLocation:
location
Description forthcoming.
setAlternateTitle:
aString

Sets the NSButtonCell's alternate title (used when highlighted) to aString and update the cell if it contains a NSControl view.

See Also: -alternateTitle

setAlternateTitleWithMnemonic:
aString
Description forthcoming.
setAttributedAlternateTitle:
aString
Description forthcoming.
setAttributedTitle:
aString
Description forthcoming.
setBackgroundColor:
color
Description forthcoming.
setBezelStyle:
bezelStyle
Description forthcoming.
setButtonType:
buttonType
Description forthcoming.
setFont:
fontObject

Sets the NSButtonCell's font to fontObject. The key equivalent font size is changed to match the fontObject if needed.

See Also: [NSCell -font] -keyEquivalentFont -setKeyEquivalentFont: -setKeyEquivalentFont:size:

setGradientType:
gradientType
Description forthcoming.
setHighlightsBy:
mask

Sets a mask describing how the button cell is highlighted :

NSNoCellMask, NSContentsCellMask,NSPushInCellMask,NSChangeGrayCellMask, NSChangeBackgroundCellMask

See Also : -highlightsBy

setImageDimsWhenDisabled:
flag
Description forthcoming.
setImagePosition:
aPosition

Sets the image position. The GNUstep implementation depends only on the image position. If the image position is set to NSNoImage then the type is set to NSTextCellType , to NSImageCellType otherwise

See Also: -imagePosition

setImageScaling:
scaling
Description forthcoming.
setKeyEquivalent:
key

Sets the NSButtonCell's key equivalent to key. The key equivalent and its modifier mask are used to simulate the click of the button in [NSButton -performKeyEquivalent:]. By default NSButton hasn't key equivalent.

See Also: -keyEquivalent -setKeyEquivalentModifierMask: [NSButton -performKeyEquivalent:]

setKeyEquivalentFont:
fontObj

Sets the NSFont of the key equivalent to fontObject.

See Also: -keyEquivalentFont -setFont:

setKeyEquivalentFont:
fontName
size:
fontSize

Sets the NSFont with size fontSize of the key equivalent to fontName.

See Also: -keyEquivalentFont -setKeyEquivalentFont: -setFont:

setKeyEquivalentModifierMask:
mask

Sets the modifier mask of the NSButtonCell's key equivalent to mask. The key equivalent and its modifier mask are used to simulate the click of the button in [NSButton -performKeyEquivalent:]. By default the mask is 0.

See Also: -keyEquivalentModifierMask -setKeyEquivalent: [NSButton -performKeyEquivalent:]

setPeriodicDelay:
delay
interval:
interval

Sets the NSButtonCell's delay and interval parameters used when NSButton sends continouly action messages. By default delay is 0.4 and interval is 0.075.

See Also: -getPeriodicDelay:interval: [NSCell -trackMouse:inRect:ofView:untilMouseUp:]

setShowsBorderOnlyWhileMouseInside:
show
Description forthcoming.
setShowsStateBy:
mask
Description forthcoming.
setSound:
aSound
Description forthcoming.
setTitle:
aString

Sets the NSButtonCell's title to aString.

setTitleWithMnemonic:
aString
Description forthcoming.
setTransparent:
flag

Sets whether the button cell is transparent.

See Also: -isTransparent

showsBorderOnlyWhileMouseInside
Description forthcoming.
showsStateBy
Description forthcoming.
sound
Description forthcoming.
title

Returns the NSButtonCell's title.