<!--
{
  "availability" : [
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSButtonCell/imageDimsWhenDisabled",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(cs)NSButtonCell(py)imageDimsWhenDisabled"
  },
  "title" : "imageDimsWhenDisabled"
}
-->

# imageDimsWhenDisabled

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

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

## Discussion

When the value of this property is <doc://com.apple.documentation/documentation/Swift/true>, the button’s image and text are dimmed when the button is disabled; when it is <doc://com.apple.documentation/documentation/Swift/false>, the image and text are not dimmed in the disabled state. By default, all button types except [`NSSwitchButton`](/documentation/AppKit/NSSwitchButton) and [`NSRadioButton`](/documentation/AppKit/NSRadioButton) dim when disabled. When buttons of type [`NSSwitchButton`](/documentation/AppKit/NSSwitchButton) and [`NSRadioButton`](/documentation/AppKit/NSRadioButton) are disabled, only the associated text dims.

The default setting for this state is reasserted whenever you invoke [`setButtonType(_:)`](/documentation/AppKit/NSButtonCell/setButtonType(_:)), so be sure to specify the button cell’s type before you set [`imageDimsWhenDisabled`](/documentation/AppKit/NSButtonCell/imageDimsWhenDisabled).

## See Also

[`setButtonType(_:)`](/documentation/AppKit/NSButtonCell/setButtonType(_:))

Sets how the button highlights while pressed and how it shows its state.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)