Mac Developer Library

Developer

AppKit Framework Reference NSScrollView Class Reference

Options
Deployment Target:

On This Page
Language:

NSScrollView

The NSScrollView class is the central coordinator for the Application Kit’s scrolling machinery, composed of this class, and the NSClipView, and NSScroller classes . A scroll view displays a portion of a document view that’s too large to be displayed whole and provides scroll bars that allow the user to move the document view within the scroll view. More...

Inheritance


Import Statement


import AppKit @import AppKit;

Availability


Available in OS X v10.0 and later.
  • Sets the color of the content view’s background to aColor.

    Declaration

    Swift

    @NSCopying var backgroundColor: NSColor

    Objective-C

    @property(copy) NSColor *backgroundColor

    Discussion

    This color is used to paint areas inside the content view that aren’t covered by the document view.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the content view’s background color.

    Declaration

    Swift

    @NSCopying var backgroundColor: NSColor

    Objective-C

    @property(copy) NSColor *backgroundColor

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns YEStrue if the receiver cell fills the background with its background color; otherwise, NOfalse.

    Declaration

    Swift

    var drawsBackground: Bool

    Objective-C

    @property BOOL drawsBackground

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets whether the receiver draws its background.

    Declaration

    Swift

    var drawsBackground: Bool

    Objective-C

    @property BOOL drawsBackground

    Discussion

    If flag is NOfalse, copy-on-scroll is automatically disabled.

    If your NSScrollView encloses an NSClipView sending a setDrawsBackground: message with a parameter of NOfalse to the NSScrollView has the added effect of sending the NSClipView a setCopiesOnScroll: message with a parameter of NOfalse. The side effect of sending the setDrawsBackground: message directly to the NSClipView instead would be the appearance of “trails” (vestiges of previous drawing) in the document view as it is scrolled.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    See Also

    – drawsBackground
    copiesOnScroll (NSClipView)
    setDrawsBackground: (NSClipView)

  • Sets the border type of the receiver to borderType.

    Declaration

    Swift

    var borderType: NSBorderType

    Objective-C

    @property NSBorderType borderType

    Parameters

    borderType

    Specifies the appearance of the style of the scroll view’s border. See NSBorderType for a list of possible values.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    See Also

    – borderType

  • Returns a value that represents the type of border surrounding the receiver

    Declaration

    Swift

    var borderType: NSBorderType

    Objective-C

    @property NSBorderType borderType

    Return Value

    Returns the border type. See NSBorderType for a list of possible values.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the cursor used when the cursor is over the content view to aCursor, by sending setDocumentCursor: to the content view.

    Declaration

    Swift

    var documentCursor: NSCursor?

    Objective-C

    @property(strong) NSCursor *documentCursor

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the content view’s document cursor.

    Declaration

    Swift

    var documentCursor: NSCursor?

    Objective-C

    @property(strong) NSCursor *documentCursor

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the receiver’s content view, the view that clips the document view, to aView.

    Declaration

    Swift

    var contentView: NSClipView

    Objective-C

    @property(strong) NSClipView *contentView

    Discussion

    If aView has a document view, this method also sets the receiver’s document view to be the document view of aView. The original content view retains its document view.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the receiver’s content view, the view that clips the document view.

    Declaration

    Swift

    var contentView: NSClipView

    Objective-C

    @property(strong) NSClipView *contentView

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the receiver’s document view to aView.

    Declaration

    Swift

    unowned(unsafe) var documentView: AnyObject?

    Objective-C

    @property(assign) id documentView

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    See Also

    – documentView
    setDocumentView: (NSClipView)

  • Returns the view the receiver scrolls within its content view.

    Declaration

    Swift

    unowned(unsafe) var documentView: AnyObject?

    Objective-C

    @property(assign) id documentView

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

    See Also

    – setDocumentView:
    documentView (NSClipView)

  • Adds a floating subview to the document view.

    Declaration

    Swift

    func addFloatingSubview(_ view: NSView, forAxis axis: NSEventGestureAxis)

    Objective-C

    - (void)addFloatingSubview:(NSView *)view forAxis:(NSEventGestureAxis)axis

    Parameters

    view

    The view that can float.

    axis

    The event gesture axis on which the view can float. A view can float on only one axis at a time.

    Discussion

    Floating subviews of the document view do not scroll like the rest of the document. Instead these views appear to float over the document. For example, see NSTableView floating group rows (floatsGroupRows).

    NSScrollView ensures that any scrolling on the non-floating axis is performed visually synchronously with the document content.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.9 and later.

  • Sets the knob style of scroll views that use the overlay scroller style

    Declaration

    Swift

    var scrollerKnobStyle: NSScrollerKnobStyle

    Objective-C

    @property NSScrollerKnobStyle scrollerKnobStyle

    Parameters

    newScrollerKnobStyle

    The scroll knob style. See NSScrollerKnobStyle for the supported values.

    Discussion

    Applicable only to scroll views that use overlay scrollers.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.7 and later.

  • Returns the scroll knob style.

    Declaration

    Swift

    var scrollerKnobStyle: NSScrollerKnobStyle

    Objective-C

    @property NSScrollerKnobStyle scrollerKnobStyle

    Return Value

    The scroll knob style. See NSScrollerKnobStyle for the supported values.

    Discussion

    Applicable only to scroll views that use overlay scrollers.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.7 and later.

  • Determines the scroller style used by the scroll view.

    Declaration

    Swift

    var scrollerStyle: NSScrollerStyle

    Objective-C

    @property NSScrollerStyle scrollerStyle

    Parameters

    newScrollerStyle

    The scroller style. See NSScrollerStyle for supported values.

    Discussion

    This setting is automatically set at runtime, based on the user's preference setting and, if relevant, the set of connected pointing devices and their configured scroll capabilities, as determined by the NSScroller method preferredScrollerStyle.

    Setting an scroll view’s scroller style sets the style of both the horizontal and vertical scrollers. If the scroll view subsequently creates or is assigned a new horizontal or vertical scroller, they are assigned the same scroller style assigned to the scroll view.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.7 and later.

  • Returns the scroll view’s scroller style.

    Declaration

    Swift

    var scrollerStyle: NSScrollerStyle

    Objective-C

    @property NSScrollerStyle scrollerStyle

    Return Value

    Returns scroller style. See NSScrollerStyle for supported values.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.7 and later.

  • Sets the horizontal and vertical line scroll amounts to aFloat.

    Declaration

    Swift

    var lineScroll: CGFloat

    Objective-C

    @property CGFloat lineScroll

    Parameters

    aFloat

    The amount by which the receiver scrolls itself when scrolling line by line, expressed in the content view’s coordinate system.

    Discussion

    This value is used when the user clicks the scroll arrows without holding down a modifier key. When displaying text in an NSScrollView, for example, you might set this value to the height of a single line of text in the default font.

    As part of its implementation, this method calls setVerticalLineScroll: and setHorizontalLineScroll:.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the vertical line by line scroll amount.

    Declaration

    Swift

    var lineScroll: CGFloat

    Objective-C

    @property CGFloat lineScroll

    Return Value

    Returns the vertical line scroll amount: the amount by which the receiver scrolls itself vertically when scrolling line by line, expressed in the content view’s coordinate system.

    Discussion

    This amount is used when the user clicks the scroll arrows on the vertical scroll bar without holding down a modifier key. As part of its implementation, this method calls verticalLineScroll.

    Note that a scroll view can have two different line scroll amounts: verticalLineScroll and horizontalLineScroll. Use this method only if you can be sure they’re both the same; for example, you always use setLineScroll:, which sets both amounts to the same value.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the amount by which the receiver scrolls itself horizontally when scrolling line by line to aFloat, expressed in the content view’s coordinate system.

    Declaration

    Swift

    var horizontalLineScroll: CGFloat

    Objective-C

    @property CGFloat horizontalLineScroll

    Discussion

    This amount is the amount used when the user clicks the scroll arrows on the horizontal scroll bar without holding down a modifier key. When displaying text in an NSScrollView, for example, you might set this amount to the height of a single line of text in the default font.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the horizontal line by line scroll amount.

    Declaration

    Swift

    var horizontalLineScroll: CGFloat

    Objective-C

    @property CGFloat horizontalLineScroll

    Return Value

    Returns the horizontal line scroll amount: the amount by which the receiver scrolls itself horizontal when scrolling line by line, expressed in the content view’s coordinate system.

    Discussion

    This amount is used when the user clicks the scroll arrows on the horizontal scroll bar without holding down a modifier key.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the amount by which the receiver scrolls itself vertically when scrolling line by line to aFloat, expressed in the content view’s coordinate system.

    Declaration

    Swift

    var verticalLineScroll: CGFloat

    Objective-C

    @property CGFloat verticalLineScroll

    Discussion

    This value is the amount used when the user clicks the scroll arrows on the vertical scroll bar without holding down a modifier key. When displaying text in an NSScrollView, for example, you might set this value to the height of a single line of text in the default font.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the amount by which the receiver scrolls itself vertically when scrolling line by line, expressed in the content view’s coordinate system.

    Declaration

    Swift

    var verticalLineScroll: CGFloat

    Objective-C

    @property CGFloat verticalLineScroll

    Discussion

    This amount is used when the user clicks the scroll arrows on the vertical scroll bar without holding down a modifier key.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the horizontal and vertical page scroll amounts to aFloat.

    Declaration

    Swift

    var pageScroll: CGFloat

    Objective-C

    @property CGFloat pageScroll

    Discussion

    The page scroll is the amount of the document view kept visible when scrolling page by page to aFloat, expressed in the content view’s coordinate system. It’s used when the user clicks the scroll arrows while holding down the Option key.

    This amount expresses the context that remains when the receiver scrolls by one page, allowing the user to orient to the new display. It differs from the line scroll amount, which indicates how far the document view moves. The page scroll amount is the amount common to the content view before and after the document view is scrolled by one page. Thus, setting the page scroll amount to 0.0 implies that the entire visible portion of the document view is replaced when a page scroll occurs.

    As part of its implementation, this method calls setVerticalPageScroll: and setHorizontalPageScroll:.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the vertical page scroll amount: the amount of the document view kept visible when scrolling vertically page by page, expressed in the content view’s coordinate system.

    Declaration

    Swift

    var pageScroll: CGFloat

    Objective-C

    @property CGFloat pageScroll

    Discussion

    This amount is used when the user clicks the scroll arrows on the vertical scroll bar while holding down the Option key. As part of its implementation, this method calls verticalPageScroll.

    This amount expresses the context that remains when the receiver scrolls by one page, allowing the user to orient to the new display. It differs from the line scroll amount, which indicates how far the document view moves. The page scroll amount is the amount common to the content view before and after the document view is scrolled by one page.

    Note that a scroll view can have two different page scroll amounts: verticalPageScroll and horizontalPageScroll. Use this method only if you can be sure they’re both the same; for example, you always use setPageScroll:, which sets both amounts to the same value.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the amount of the document view kept visible when scrolling horizontally page by page to aFloat, expressed in the content view’s coordinate system.

    Declaration

    Swift

    var horizontalPageScroll: CGFloat

    Objective-C

    @property CGFloat horizontalPageScroll

    Discussion

    This amount is used when the user clicks the scroll arrows on the horizontal scroll bar while holding down the Option key.

    This amount expresses the context that remains when the receiver scrolls by one page, allowing the user to orient to the new display. It differs from the line scroll amount, which indicates how far the document view moves. The page scroll amount is the amount common to the content view before and after the document view is scrolled by one page. Thus, setting the page scroll amount to 0.0 implies that the entire visible portion of the document view is replaced when a page scroll occurs.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the amount of the document view kept visible when scrolling horizontally page by page, expressed in the content view’s coordinate system.

    Declaration

    Swift

    var horizontalPageScroll: CGFloat

    Objective-C

    @property CGFloat horizontalPageScroll

    Discussion

    This amount is used when the user clicks the scroll arrows on the horizontal scroll bar while holding down the Option key.

    This amount expresses the context that remains when the receiver scrolls by one page, allowing the user to orient to the new display. It differs from the line scroll amount, which indicates how far the document view moves. The page scroll amount is the amount common to the content view before and after the document view is scrolled by one page.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets the amount of the document view kept visible when scrolling vertically page by page to aFloat, expressed in the content view’s coordinate system.

    Declaration

    Swift

    var verticalPageScroll: CGFloat

    Objective-C

    @property CGFloat verticalPageScroll

    Discussion

    This amount is used when the user clicks the scroll arrows on the vertical scroll bar while holding down the Option key.

    This amount expresses the context that remains when the receiver scrolls by one page, allowing the user to orient to the new display. It differs from the line scroll amount, which indicates how far the document view moves. The page scroll amount is the amount common to the content view before and after the document view is scrolled by one page. Thus, setting the page scroll amount to 0.0 implies that the entire visible portion of the document view is replaced when a page scroll occurs.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns the amount of the document view kept visible when scrolling vertically page by page, expressed in the content view’s coordinate system.

    Declaration

    Swift

    var verticalPageScroll: CGFloat

    Objective-C

    @property CGFloat verticalPageScroll

    Discussion

    This amount is used when the user clicks the scroll arrows on the vertical scroll bar while holding down the Option key.

    This amount expresses the context that remains when the receiver scrolls by one page, allowing the user to orient to the new display. It differs from the line scroll amount, which indicates how far the document view moves. The page scroll amount is the amount common to the content view before and after the document view is scrolled by one page.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Determines whether the receiver redraws its document view while scrolling continuously.

    Declaration

    Swift

    var scrollsDynamically: Bool

    Objective-C

    @property BOOL scrollsDynamically

    Discussion

    If flag is YEStrue it does; if flag is NOfalse it redraws only when the scroller knob is released. NSScrollView scrolls dynamically by default.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Returns YEStrue if the receiver redraws its document view while tracking the knob, NOfalse if it redraws only when the scroller knob is released.

    Declaration

    Swift

    var scrollsDynamically: Bool

    Objective-C

    @property BOOL scrollsDynamically

    Discussion

    NSScrollView scrolls dynamically by default.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Scrolls the receiver up or down, in response to the user moving the mouse’s scroll wheel specified by theEvent.

    Declaration

    Swift

    func scrollWheel(_ theEvent: NSEvent)

    Objective-C

    - (void)scrollWheel:(NSEvent *)theEvent

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Adjusts the receiver’s scrollers to reflect the size and positioning of its content view.

    Declaration

    Swift

    func reflectScrolledClipView(_ aClipView: NSClipView)

    Objective-C

    - (void)reflectScrolledClipView:(NSClipView *)aClipView

    Parameters

    aClipView

    The clip view being adjusted to. If aClipView is any view object other than the receiver’s content view, the method does nothing.

    Discussion

    This method is invoked automatically during scrolling and when an NSClipView object’s relationship to its document view changes; you should rarely need to invoke it yourself, but may wish to override it for custom updating or other behavior. If you override this method, be sure to call the superclass implementation. If you do not, other controls (such as the current scrollers) may not be updated properly.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Lays out the components of the receiver: the content view, the scrollers, and the ruler views.

    Declaration

    Swift

    func tile()

    Objective-C

    - (void)tile

    Discussion

    You rarely need to invoke this method, but subclasses may override it to manage additional components.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.0 and later.

  • Sets whether the scroll view uses a predominant scrolling axis for content.

    Declaration

    Swift

    var usesPredominantAxisScrolling: Bool

    Objective-C

    @property BOOL usesPredominantAxisScrolling

    Parameters

    predominantAxisScrolling

    The whether the scroll view supports a predominant scrolling direction. YEStrue if there is a predominant scrolling direction; otherwise NOfalse.

    Discussion

    Some content is scrollable in both the horizontal and vertical axes, but is predominantly scrolled one axis at a time. Other content (such as a drawing canvas) should scroll freely in both axes.

    Traditionally this is not an issue with scroll wheels since they can only scroll in one direction at a time. With scroll balls and touch surfaces, it becomes more difficult to determine the user's intention.

    This property helps a scroll view determine the user's intention by specifying if there is a predominant scrolling axis for content.

    The default value is YEStrue.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.7 and later.

  • Returns whether the scroll view uses a predominant scrolling axis for content.

    Declaration

    Swift

    var usesPredominantAxisScrolling: Bool

    Objective-C

    @property BOOL usesPredominantAxisScrolling

    Return Value

    YES if it does; NO otherwise.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.7 and later.

  • Flash the overlay scroll bars.

    Declaration

    Swift

    func flashScrollers()

    Objective-C

    - (void)flashScrollers

    Discussion

    This method is only to scroll views that use overlay scrollers.

    This method can be invoked to cause the overlay scroller knobs to be momentarily shown. This may be desirable when changing a document view's size or swapping new content into the view, or to give the user a sense of the current position within the scrollable range at each step of an incremental search or similar operation.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.7 and later.

  • Allows the user to magnify the scroll view.

    Declaration

    Swift

    var allowsMagnification: Bool

    Objective-C

    @property BOOL allowsMagnification

    Discussion

    This property does not prevent the developer from manually adjusting the magnification value. If magnification exceeds either the maximum or minimum limits for magnification, and allowsMagnification is YEStrue, the scroll view temporarily animates the content magnification just past those limits before returning to them. The default value is NOfalse.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.8 and later.

  • The amount by which the content is currently scaled.

    Declaration

    Swift

    var magnification: CGFloat

    Objective-C

    @property CGFloat magnification

    Discussion

    To animate the magnification, use the object's animator. The default value is 1.0.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.8 and later.

  • Magnifies the content view proportionally such that the given rectangle fits centered in the scroll view.

    Declaration

    Swift

    func magnifyToFitRect(_ rect: NSRect)

    Objective-C

    - (void)magnifyToFitRect:(NSRect)rect

    Parameters

    rect

    The rectangle (in content view space) to which the content view is magnified.

    Discussion

    The resulting magnification value is clipped to the minMagnification and maxMagnification values. To animate the magnification, use the object's animator.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.8 and later.

  • The maximum value to which the content can be magnified.

    Declaration

    Swift

    var maxMagnification: CGFloat

    Objective-C

    @property CGFloat maxMagnification

    Discussion

    This value must be greater than or equal to the minimum magnification. The default value is 4.0.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.8 and later.

  • The minimum value to which the content can be magnified.

    Declaration

    Swift

    var minMagnification: CGFloat

    Objective-C

    @property CGFloat minMagnification

    Discussion

    The default value is 0.25.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.8 and later.

  • Magnify the content by the given amount and center the result on the given point.

    Declaration

    Swift

    func setMagnification(_ magnification: CGFloat, centeredAtPoint point: NSPoint)

    Objective-C

    - (void)setMagnification:(CGFloat)magnification centeredAtPoint:(NSPoint)point

    Parameters

    magnification

    The amount by which to magnify the content.

    point

    The point (in content view space) on which to center magnification.

    Discussion

    This method scales the content view such that the passed in point (in content view space) remains at the same screen location once the scaling is completed. The resulting magnification value is clipped to the minMagnification and maxMagnification values. To animate the magnification, use the object's animator.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.8 and later.

  • These constants determine the elasticity behavior for an axis of the scrollview.

    Declaration

    Swift

    enum NSScrollElasticity : Int { case Automatic case None case Allowed }

    Objective-C

    enum { NSScrollElasticityAutomatic = 0, NSScrollElasticityNone = 1, NSScrollElasticityAllowed = 2, }; typedef NSInteger NSScrollElasticity;

    Constants

    • Automatic

      NSScrollElasticityAutomatic

      Automatically determine whether to allow elasticity on this axis.

      Available in OS X v10.7 and later.

    • None

      NSScrollElasticityNone

      Disallow scrolling beyond document bounds on this axis.

      Available in OS X v10.7 and later.

    • Allowed

      NSScrollElasticityAllowed

      Allow content to be scrolled past its bounds on this axis in an elastic fashion.

      Available in OS X v10.7 and later.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.7 and later.

  • These constants define the position of the find bar in relation to the scroll view.

    Declaration

    Swift

    enum NSScrollViewFindBarPosition : Int { case AboveHorizontalRuler case AboveContent case BelowContent }

    Objective-C

    enum { NSScrollViewFindBarPositionAboveHorizontalRuler = 0, NSScrollViewFindBarPositionAboveContent = 1, NSScrollViewFindBarPositionBelowContent = 2 }; typedef NSInteger NSScrollViewFindBarPosition;

    Constants

    • AboveHorizontalRuler

      NSScrollViewFindBarPositionAboveHorizontalRuler

      The find bar is displayed above the horizontal ruler, if visible.

      Available in OS X v10.7 and later.

    • AboveContent

      NSScrollViewFindBarPositionAboveContent

      The find bar is displayed above the scroll view content.

      Available in OS X v10.7 and later.

    • BelowContent

      NSScrollViewFindBarPositionBelowContent

      The find bar is displayed below the scroll view content.

      Available in OS X v10.7 and later.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.7 and later.

  • Posted at the beginning of a magnify gesture.

    The notification object is the scroll view performing the magnification.

    This notification indicates that the magnification property is being changed due to user action. This may be due to the user performing a pinch gesture or a smart zoom gesture. When animating the magnification value yourself via the object's animator, this notification is not sent.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.8 and later.

  • Posted at the end of a magnify gesture.

    The notification object is the scroll view performing the magnification.

    This notification indicates that the magnification property is being changed due to user action. This may be due to the user performing a pinch gesture or a smart zoom gesture. When animating the magnification value yourself via the object's animator, this notification is not sent.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.8 and later.

  • Posted on the main thread at the beginning of user-initiated live scroll tracking (gesture scroll or scroller tracking, for example, thumb dragging).

    The notification object is the scroll view performing the scroll.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.9 and later.

  • Posted on the main thread after changing the clipview bounds origin due to a user-initiated event.

    Some user-initiated scrolls (for example, scrolling using legacy mice) are not bracketed by a “willStart/didEnd” notification pair.

    The notification object is the scroll view performing the scroll.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.9 and later.

  • Posted on the main thread at the end of live scroll tracking.

    The notification object is the scroll view performing the scroll.

    Import Statement

    import AppKit

    Availability

    Available in OS X v10.9 and later.