NextEventMatchingMaskUntilDateInModeDequeue Method (mask, expiration, mode, flag)

Returns the next event matching a given mask, or nil if no such event is found before a specified expiration date.

Original signature is '- (NSEvent *)nextEventMatchingMask:(NSUInteger)mask untilDate:(NSDate *)expiration inMode:(NSString *)mode dequeue:(BOOL)flag'

Available in Mac OS X v10.0 and later.

Declaration Syntax

Visual Basic

Visual C++

public virtual NSEvent NextEventMatchingMaskUntilDateInModeDequeue(
	NSEventMask mask,
	NSDate expiration,
	NSString mode,
	bool flag
)

Public Overridable Function NextEventMatchingMaskUntilDateInModeDequeue ( _
	mask As NSEventMask, _
	expiration As NSDate, _
	mode As NSString, _
	flag As Boolean _
) As NSEvent

public:
virtual NSEvent^ NextEventMatchingMaskUntilDateInModeDequeue(
	NSEventMask mask, 
	NSDate^ expiration, 
	NSString^ mode, 
	bool flag
)

Parameters

mask (NSEventMask): Contains one or more flags indicating the types of events to return. The constants section of the NSEvent class defines the constants you can add together to create this mask. The discardEventsMatchingMask:beforeEvent: method also lists several of these constants.

expiration (NSDate): The expiration date for the current event request. Specifying nil for this parameter is equivalent to returning a date object using the distantPast method.

mode (NSString): The run loop mode in which to run while looking for events. The mode you specify also determines which timers and run-loop observers may fire while the application waits for the event.

flag (Boolean): Specify YES if you want the event removed from the queue.

Return Value

The event object whose type matches one of the event types specified by the mask parameter.

Version Information

Available in Monobjc Bridge: 10.6 (For Mac OS X 10.6 and later), 10.5 (For Mac OS X 10.5 and later)

Assembly: Monobjc.AppKit (Module: Monobjc.AppKit)