Instance Property

imageDimsWhenDisabled

A Boolean value that indicates if the button’s image and text appear “dim” when the button is disabled.

Declaration

@property BOOL imageDimsWhenDisabled;

Discussion

When the value of this property is YES, the button's image and text are dimmed when the button is disabled; when it is NO, the image and text are not dimmed in the disabled state. By default, all button types except NSSwitchButton and NSRadioButton dim when disabled. When buttons of type NSSwitchButton and NSRadioButton are disabled, only the associated text dims.

The default setting for this state is reasserted whenever you invoke setButtonType:, so be sure to specify the button cell’s type before you set imageDimsWhenDisabled.

See Also

Managing Graphics Attributes

backgroundColor

The background color of the button.

bezelStyle

The appearance of the button’s border, if it has one.

gradientType

The gradient of the button’s border.

Deprecated
opaque

A Boolean value that indicates if the button is opaque.

transparent

A Boolean value that indicates if the button is transparent.

showsBorderOnlyWhileMouseInside

A Boolean value that indicates if the button displays its border only when the pointer is over it.