<!--
{
  "availability" : [
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSColorPickingDefault",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(pl)NSColorPickingDefault"
  },
  "title" : "NSColorPickingDefault"
}
-->

# NSColorPickingDefault

A set of methods that provides basic behavior for a color picker.

```
protocol NSColorPickingDefault
```

## Overview

The [`NSColorPickingDefault`](/documentation/AppKit/NSColorPickingDefault) protocol, together with the [`NSColorPickingCustom`](/documentation/AppKit/NSColorPickingCustom) protocol (which provides implementation-specific behavior), provides an interface for adding color pickers to an app’s color panel.

## Topics

### Creating Color Pickers

[`-  initWithPickerMask:colorPanel:`](/documentation/AppKit/NSColorPickingDefault/init(pickerMask:colorPanel:))

Initializes the receiver with a given color panel and its mode.

### Configuring Color Pickers

[`-  setMode:`](/documentation/AppKit/NSColorPickingDefault/setMode(_:))

Specifies the receiver’s mode.

[`-  insertNewButtonImage:in:`](/documentation/AppKit/NSColorPickingDefault/insertNewButtonImage(_:in:))

Sets the image of a given button cell.

[`-  provideNewButtonImage`](/documentation/AppKit/NSColorPickingDefault/provideNewButtonImage())

Provides the image of the button used to select the receiver in the color panel.

[`-  minContentSize`](/documentation/AppKit/NSColorPickingDefault/minContentSize())

Indicates the receiver’s minimum content size.

[`-  buttonToolTip`](/documentation/AppKit/NSColorPickingDefault/buttonToolTip())

Provides the toolbar button help tag.

### Handling Events

[`-  alphaControlAddedOrRemoved:`](/documentation/AppKit/NSColorPickingDefault/alphaControlAddedOrRemoved(_:))

Sent when the color panel’s opacity controls have been hidden or displayed.

[`-  viewSizeChanged:`](/documentation/AppKit/NSColorPickingDefault/viewSizeChanged(_:))

Tells the recever when the color panel’s view size changes in a way that might affect the color picker.

### Managing Color Lists

[`-  attachColorList:`](/documentation/AppKit/NSColorPickingDefault/attachColorList(_:))

Tells the receiver to attach the given color list, if it isn’t already displaying the list.

[`-  detachColorList:`](/documentation/AppKit/NSColorPickingDefault/detachColorList(_:))

Tells the receiver to detach the given color list, unless the receiver isn’t displaying the list.

## Relationships

### Inherited By

[`NSColorPickingCustom`](/documentation/AppKit/NSColorPickingCustom)

### Conforming Types

[`NSColorPicker`](/documentation/AppKit/NSColorPicker)

---

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)