<!--
{
  "availability" : [
    "macOS: 10.7.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSScroller/preferredScrollerStyle",
  "metadataVersion" : "0.1.0",
  "role" : "Type Property",
  "symbol" : {
    "kind" : "Type Property",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(cs)NSScroller(cpy)preferredScrollerStyle"
  },
  "title" : "preferredScrollerStyle"
}
-->

# preferredScrollerStyle

Returns the style of scrollers that applications should use wherever possible.

```
class var preferredScrollerStyle: NSScroller.Style { get }
```

## Return Value

The style of scrollers that applications should use wherever possible.

## Discussion

The preferred scroller style is determined by the Appearance preference panel’s “Show scroll bars” setting for the current user, and—when the user’s preference is set to “Automatically based on input device”—by the set of built-in and connected pointing devices and the user’s scroll capability preference settings for them. The preferred scroller style may therefore change over time, and applications should be prepared to adapt their user interfaces to the new scroller style if needed.

In most cases, updating to a new scroller style is automatic: When the preferred scroller style changes, AppKit notifies all [`NSScrollView`](/documentation/AppKit/NSScrollView) instances, setting the [`scrollerStyle`](/documentation/AppKit/NSScroller/scrollerStyle) property of each with the new style, which causes each scroll view to automatically re-tile (update its layout) to adapt to the new scroller style. Some `NSScrollView` instances may refuse the new scroller style setting if they cannot accommodate it for compatibility reasons (the presence of accessory views or legacy scroller subclasses prevent use of overlay scrollers), but most instances will switch to the specified new preferred scroller style.

If you need to be notified of changes to the preferred scroller style, you can register to receive [`preferredScrollerStyleDidChangeNotification`](/documentation/AppKit/NSScroller/preferredScrollerStyleDidChangeNotification) notifications.

---

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)