Instance Method

prepareContentInRect:

Prepares the overdraw region for drawing.

Declaration

- (void)prepareContentInRect:(NSRect)rect;

Parameters

rect

The current overdraw region, specified in the view’s coordinate system. This rectangle includes the view’s visible rectangle plus any space surrounding the visible rectangle that represents the overdraw region.

Discussion

During responsive scrolling, AppKit calls this method before asking your view to draw any content in the overdraw region. You can override this method in your own views and use it to prepare the content that is about to be drawn. For example, if your app defers the creation of subviews until they are scrolled into view, you would use this method to create them and add them to your view hierarchy.

Your implementation of this method must call super at some point. When calling super, you can extend the overdraw rectangle by passing a different rectangle for the rect parameter. For example, if you add a subview whose frame falls outside the current rectangle, you can grow the rectangle to include the entire frame of the subview.

AppKit may call this method multiple times to build up the current overdraw region slowly. Each time it calls the method, it extends the overdraw rectangle passed in the rect parameter. If you pass the same rectangle to super twice in succession, AppKit stops generating additional overdraw content. You can use this behavior to avoid generating more overdraw content than makes sense for your app. If the user scrolls the content, AppKit resets the current overdraw region and starts asking your app for content again. You can also reset the current overdraw region by assigning a value to the preparedContentRect property.

See Also

Scrolling

preparedContentRect

The portion of the view that has been rendered and is available for responsive scrolling.

- scrollPoint:

Scrolls the view’s closest ancestor NSClipView object so a point in the view lies at the origin of the clip view's bounds rectangle.

- scrollRectToVisible:

Scrolls the view’s closest ancestor NSClipView object the minimum distance needed so a specified region of the view becomes visible in the clip view.

- autoscroll:

Scrolls the view’s closest ancestor NSClipView object proportionally to the distance of an event that occurs outside of it.

- adjustScroll:

Overridden by subclasses to modify a given rectangle, returning the altered rectangle.

- scrollRect:by:

Copies the visible portion of the view’s rendered image within a region and lays that portion down again at a specified offset .

Deprecated
enclosingScrollView

The nearest ancestor scroll view that contains the current view.

- scrollClipView:toPoint:

Notifies the superview of a clip view that the clip view needs to reset the origin of its bounds rectangle.

- reflectScrolledClipView:

Notifies a clip view’s superview that either the clip view’s bounds rectangle or the document view’s frame rectangle has changed, and that any indicators of the scroll position need to be adjusted.