Instance Method

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.

Declaration

- (BOOL)acceptsFirstMouse:(NSEvent *)event;

Parameters

theEvent

The initial mouse-down event, which must be over the view in its window.

Discussion

The view can either return a value unconditionally or use the location of theEvent to determine whether or not it wants the event. The default implementation ignores theEvent and returns NO.

Override this method in a subclass to allow instances to respond to click-through. This allows the user to click on a view in an inactive window, activating the view with one click, instead of clicking first to make the window active and then clicking the view. Most view objects refuse a click-through attempt, so the event simply activates the window. Many control objects, however, such as instances of NSButton and NSSlider, do accept them, so the user can immediately manipulate the control without having to release the mouse button.

See Also

Event Handling

- 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.

- 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.