---
title: imageDimsWhenDisabled
framework: appkit
role: symbol
role_heading: Instance Property
path: appkit/nsbuttoncell/imagedimswhendisabled
---

# imageDimsWhenDisabled

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

## Declaration

```swift
var imageDimsWhenDisabled: Bool { get set }
```

## Discussion

Discussion When the value of this property is true, the button’s image and text are dimmed when the button is disabled; when it is false, 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

### Related Documentation

- [setButtonType(_:)](appkit/nsbuttoncell/setbuttontype(_:).md)

### Managing Graphics Attributes

- [backgroundColor](appkit/nsbuttoncell/backgroundcolor.md)
- [bezelStyle](appkit/nsbuttoncell/bezelstyle.md)
- [gradientType](appkit/nsbuttoncell/gradienttype.md)
- [isOpaque](appkit/nsbuttoncell/isopaque.md)
- [isTransparent](appkit/nsbuttoncell/istransparent.md)
- [showsBorderOnlyWhileMouseInside](appkit/nsbuttoncell/showsborderonlywhilemouseinside.md)