mirror of
https://github.com/gnustep/libs-base.git
synced 2025-04-27 10:40:50 +00:00
f13d56d8ec
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@29615 72102866-910b-0410-8b05-ffd578937521
145 lines
4.2 KiB
Objective-C
145 lines
4.2 KiB
Objective-C
/*
|
|
NSNotificationQueue.h
|
|
|
|
Copyright (C) 1995, 1996 Ovidiu Predescu and Mircea Oancea.
|
|
All rights reserved.
|
|
|
|
Author: Mircea Oancea <mircea@jupiter.elcom.pub.ro>
|
|
|
|
This file is part of libFoundation.
|
|
|
|
Permission to use, copy, modify, and distribute this software and its
|
|
documentation for any purpose and without fee is hereby granted, provided
|
|
that the above copyright notice appear in all copies and that both that
|
|
copyright notice and this permission notice appear in supporting
|
|
documentation.
|
|
|
|
We disclaim all warranties with regard to this software, including all
|
|
implied warranties of merchantability and fitness, in no event shall
|
|
we be liable for any special, indirect or consequential damages or any
|
|
damages whatsoever resulting from loss of use, data or profits, whether in
|
|
an action of contract, negligence or other tortious action, arising out of
|
|
or in connection with the use or performance of this software.
|
|
*/
|
|
/* Interface for NSNotificationQueue for GNUStep
|
|
Copyright (C) 1996 Free Software Foundation, Inc.
|
|
|
|
Modified by: Richard Frith-Macdonald <richard@brainstorm.co.uk>
|
|
|
|
This file is part of the GNUstep Base Library.
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2 of the License, or (at your option) any later version.
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Library General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with this library; if not, write to the Free
|
|
Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
Boston, MA 02111 USA.
|
|
*/
|
|
|
|
#ifndef __NSNotificationQueue_h_GNUSTEP_BASE_INCLUDE
|
|
#define __NSNotificationQueue_h_GNUSTEP_BASE_INCLUDE
|
|
#import <GNUstepBase/GSVersionMacros.h>
|
|
|
|
#import <Foundation/NSObject.h>
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
@class NSArray;
|
|
@class NSNotification;
|
|
@class NSNotificationCenter;
|
|
|
|
/*
|
|
* Posting styles into notification queue
|
|
*/
|
|
|
|
/**
|
|
* Enumeration of possible timings for distribution of notifications handed
|
|
* to an [NSNotificationQueue]:
|
|
<example>
|
|
{
|
|
NSPostWhenIdle, // post when runloop is idle
|
|
NSPostASAP, // post soon
|
|
NSPostNow // post synchronously
|
|
}
|
|
</example>
|
|
*/
|
|
enum {
|
|
NSPostWhenIdle = 1,
|
|
NSPostASAP = 2,
|
|
NSPostNow = 3
|
|
};
|
|
typedef NSUInteger NSPostingStyle;
|
|
|
|
/**
|
|
* Enumeration of possible ways to combine notifications when dealing with
|
|
* [NSNotificationQueue]:
|
|
<example>
|
|
{
|
|
NSNotificationNoCoalescing, // don't combine
|
|
NSNotificationCoalescingOnName, // combine all registered with same name
|
|
NSNotificationCoalescingOnSender // combine all registered with same object
|
|
}
|
|
</example>
|
|
*/
|
|
enum {
|
|
NSNotificationNoCoalescing = 0,
|
|
NSNotificationCoalescingOnName = 1,
|
|
NSNotificationCoalescingOnSender = 2,
|
|
};
|
|
typedef NSUInteger NSNotificationCoalescing;
|
|
|
|
/*
|
|
* NSNotificationQueue class
|
|
*/
|
|
|
|
/**
|
|
* Structure used internally by [NSNotificationQueue].
|
|
*/
|
|
struct _NSNotificationQueueList;
|
|
|
|
@interface NSNotificationQueue : NSObject
|
|
{
|
|
#if GS_EXPOSE(NSNotificationQueue)
|
|
@private
|
|
NSNotificationCenter *_center;
|
|
struct _NSNotificationQueueList *_asapQueue;
|
|
struct _NSNotificationQueueList *_idleQueue;
|
|
NSZone *_zone;
|
|
#endif
|
|
}
|
|
|
|
/* Creating Notification Queues */
|
|
|
|
+ (NSNotificationQueue*) defaultQueue;
|
|
- (id) initWithNotificationCenter: (NSNotificationCenter*)notificationCenter;
|
|
|
|
/* Inserting and Removing Notifications From a Queue */
|
|
|
|
- (void) dequeueNotificationsMatching: (NSNotification*)notification
|
|
coalesceMask: (NSUInteger)coalesceMask;
|
|
|
|
- (void) enqueueNotification: (NSNotification*)notification
|
|
postingStyle: (NSPostingStyle)postingStyle;
|
|
|
|
- (void) enqueueNotification: (NSNotification*)notification
|
|
postingStyle: (NSPostingStyle)postingStyle
|
|
coalesceMask: (NSUInteger)coalesceMask
|
|
forModes: (NSArray*)modes;
|
|
|
|
@end
|
|
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif /* __NSNotificationQueue_h_GNUSTEP_BASE_INCLUDE */
|