Instance Method

nextEventMatchingMask:untilDate:inMode:dequeue:

Forwards the message to the global NSApplication object, NSApp.

Declaration

- (NSEvent *)nextEventMatchingMask:(NSEventMask)mask untilDate:(NSDate *)expiration inMode:(NSRunLoopMode)mode dequeue:(BOOL)deqFlag;

Parameters

mask

The mask that the event to return must match.

expiration

The date until which to wait for events.

mode

The run loop mode to use while waiting for events

deqFlag

YES to remove the returned event from the event queue; NO to leave the returned event in the queue.

Return Value

The next event whose mask matches the specified mask; nil when no matching event was found.

See Also

Handling Events

+ menuChanged:

This method does nothing; it is here for backward compatibility.

Deprecated
currentEvent

The event currently being processed by the application.

- nextEventMatchingMask:

Returns the next event matching a given mask.

- discardEventsMatchingMask:beforeEvent:

Forwards the message to the NSApplication object, NSApp.

- postEvent:atStart:

Forwards the message to the global NSApplication object, NSApp.

- sendEvent:

This action method dispatches mouse and keyboard events sent to the window by the NSApplication object.

- tryToPerform:with:

Dispatches action messages with a given argument.