Instance Method

addCursorRect:cursor:

Establishes the cursor to be used when the mouse pointer lies within a specified region.

Declaration

- (void)addCursorRect:(NSRect)rect cursor:(NSCursor *)object;

Parameters

aRect

A rectangle defining a region of the view.

aCursor

An object representing a cursor.

Discussion

Cursor rectangles aren’t subject to clipping by superviews, nor are they intended for use with rotated views. You should explicitly confine a cursor rectangle to the view's visible rectangle to prevent improper behavior.

This method is intended to be invoked only by the resetCursorRects method. If invoked in any other way, the resulting cursor rectangle will be discarded the next time the view's cursor rectangles are rebuilt.

See Also

Managing Cursor Tracking

- removeCursorRect:cursor:

Completely removes a cursor rectangle from the view.

- discardCursorRects

Invalidates all cursor rectangles set up using addCursorRect:cursor:.

- resetCursorRects

Overridden by subclasses to define their default cursor rectangles.