Instance Method

hitTest:

Returns the farthest descendant of the view in the view hierarchy (including itself) that contains a specified point, or nil if that point lies completely outside the view.

Declaration

- (NSView *)hitTest:(NSPoint)point;

Parameters

aPoint

A point that is in the coordinate system of the view’s superview, not of the view itself.

Return Value

A view object that is the farthest descendent of aPoint.

Discussion

This method is used primarily by an NSWindow object to determine which view should receive a mouse-down event. You’d rarely need to invoke this method, but you might want to override it to have a view object hide mouse-down events from its subviews. This method ignores hidden views.

See Also

Event Handling

- acceptsFirstMouse:

Overridden by subclasses to return YES if the view should be sent a mouseDown: message for an initial mouse-down event, NO if not.

- mouse:inRect:

Returns whether a region of the view contains a specified point, accounting for whether the view is flipped or not.

- performKeyEquivalent:

Implemented by subclasses to respond to key equivalents (also known as keyboard shortcuts).

- rightMouseDown:

Informs the view that the user has pressed the right mouse button.

mouseDownCanMoveWindow

A Boolean value indicating whether the view can pass mouse down events through to its superviews.

inputContext

The text input context object for the view.