Class: NSNotificationQueue
Overview
NSNotificationQueue objects (or simply notification queues) act as buffers for notification centers (instances of NSNotificationCenter). Whereas a notification center distributes notifications when posted, notifications placed into the queue can be delayed until the end of the current pass through the run loop or until the run loop is idle. Duplicate notifications can also be coalesced so that only one notification is sent although multiple notifications are posted. A notification queue maintains notifications (instances of NSNotification) generally in a first in first out (FIFO) order. When a notification rises to the front of the queue, the queue posts it to the notification center, which in turn dispatches the notification to all objects registered as observers.
Class Method Summary (collapse)
-
+ defaultQueue
Returns the default notification queue for the current thread.
Instance Method Summary (collapse)
-
- dequeueNotificationsMatching:coalesceMask:
Removes all notifications from the queue that match a provided notification using provided matching criteria.
-
- enqueueNotification:postingStyle:
Adds a notification to the notification queue with a specified posting style.
-
- enqueueNotification:postingStyle:coalesceMask:forModes:
Adds a notification to the notification queue with a specified posting style, criteria for coalescing, and runloop mode.
-
- initWithNotificationCenter:
Initializes and returns a notification queue for the specified notification center.
Methods inherited from NSObject
#!, #!=, #!~, #, #==, #===, #=~, #Rational, #__callee__, #__method__, #__send__, #__type__, `, alloc, allocWithZone:, #autoContentAccessingProxy, autoload, autoload?, autorelease_pool, #awakeAfterUsingCoder:, binding, block_given?, caller, cancelPreviousPerformRequestsWithTarget:, cancelPreviousPerformRequestsWithTarget:selector:object:, catch, class, classFallbacksForKeyedArchiver, #classForCoder, #classForKeyedArchiver, classForKeyedUnarchiver, #clone, conformsToProtocol:, #copy, copyWithZone:, #dealloc, #define_singleton_method, description, display, #doesNotRecognizeSelector:, #dup, #enum_for, #eql?, #equal?, #extend, fail, #finalize, format, #forwardInvocation:, #forwardingTargetForSelector:, framework, #freeze, #frozen?, getpass, gets, global_variables, #init, initialize, #initialize_clone, #initialize_copy, #initialize_dup, #inspect, instanceMethodForSelector:, instanceMethodSignatureForSelector:, #instance_eval, #instance_exec, #instance_of?, #instance_variable_defined?, #instance_variable_get, #instance_variable_set, #instance_variables, instancesRespondToSelector:, isSubclassOfClass:, #is_a?, iterator?, #kind_of?, lambda, load, load_bridge_support_file, load_plist, local_variables, loop, #method, #methodForSelector:, #methodSignatureForSelector:, #methods, #mutableCopy, mutableCopyWithZone:, new, #nil?, open, p, #performSelector:onThread:withObject:waitUntilDone:, #performSelector:onThread:withObject:waitUntilDone:modes:, #performSelector:withObject:afterDelay:, #performSelector:withObject:afterDelay:inModes:, #performSelectorInBackground:withObject:, #performSelectorOnMainThread:withObject:waitUntilDone:, #performSelectorOnMainThread:withObject:waitUntilDone:modes:, print, printf, #private_methods, proc, #protected_methods, #public_method, #public_methods, #public_send, putc, puts, raise, rand, readline, readlines, #replacementObjectForCoder:, #replacementObjectForKeyedArchiver:, require, resolveClassMethod:, resolveInstanceMethod:, #respond_to?, #respond_to_missing?, select, #send, setVersion:, #singleton_methods, sprintf, srand, superclass, #taint, #tainted?, #tap, test, throw, #to_plist, #to_s, trace_var, trap, #trust, #untaint, untrace_var, #untrust, #untrusted?, version
Constructor Details
This class inherits a constructor from NSObject
Dynamic Method Handling
This class handles dynamic methods through the method_missing method in the class NSObject
Class Method Details
+ (NSNotificationQueue) defaultQueue
Returns the default notification queue for the current thread.
Instance Method Details
- (Object) dequeueNotificationsMatching(notification, coalesceMask:coalesceMask)
Removes all notifications from the queue that match a provided notification using provided matching criteria.
- (Object) enqueueNotification(notification, postingStyle:postingStyle)
Adds a notification to the notification queue with a specified posting style. Notifications added with this method are posted using the runloop mode NSDefaultRunLoopMode and coalescing criteria that will coalesce only notifications that match both the notification’s name and object.This method invokes enqueueNotification:postingStyle:coalesceMask:forModes:.
- (Object) enqueueNotification(notification, postingStyle:postingStyle, coalesceMask:coalesceMask, forModes:modes)
Adds a notification to the notification queue with a specified posting style, criteria for coalescing, and runloop mode.
- (Object) initWithNotificationCenter(notificationCenter)
Initializes and returns a notification queue for the specified notification center. This is the designated initializer for the NSNotificationQueue class.