preferredScrollerStyle
Returns the style of scrollers that applications should use wherever possible.
Declaration
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 instances, setting the 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 notifications.