Added partial implementation os KVO to match the accidentally comitted makefile changes.

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@21395 72102866-910b-0410-8b05-ffd578937521

Headers/Foundation/NSKeyValueObserving.h

@@ -0,0 +1,212 @@
+/* Interface for NSKeyValueObserving for GNUStep
+   Copyright (C) 2005 Free Software Foundation, Inc.
+
+   Written by:  Richard Frith-Macdonald <rfm@gnu.org>
+   Date:	2005
+   
+   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 Library 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 Library 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 __NSKeyValueObserving_h_GNUSTEP_BASE_INCLUDE
+#define __NSKeyValueObserving_h_GNUSTEP_BASE_INCLUDE
+
+#include	<Foundation/NSObject.h>
+
+#if OS_API_VERSION(100300,GS_API_LATEST) && GS_API_VERSION(010200,GS_API_LATEST)
+
+@class NSArray;
+@class NSIndexSet;
+@class NSSet;
+@class NSString;
+
+typedef enum {
+  NSKeyValueObservingOptionNew = 1,
+  NSKeyValueObservingOptionOld = 2
+} NSKeyValueObservingOptions;
+
+typedef enum {
+  NSKeyValueChangeSetting = 1,
+  NSKeyValueChangeInsertion = 2,
+  NSKeyValueChangeRemoval = 3,
+  NSKeyValueChangeReplacement = 4
+} NSKeyValueChange;
+
+typedef enum {
+  NSKeyValueUnionSetMutation = 1,
+  NSKeyValueMinusSetMutation = 2,
+  NSKeyValueIntersectSetMutation = 3,
+  NSKeyValueSetSetMutation = 4
+} NSKeyValueSetMutationKind;
+
+GS_EXPORT NSString *const NSKeyValueChangeIndexesKey;
+GS_EXPORT NSString *const NSKeyValueChangeKindKey;
+GS_EXPORT NSString *const NSKeyValueChangeNewKey;
+GS_EXPORT NSString *const NSKeyValueChangeOldKey;
+
+/* Given that the receiver has been registered as an observer
+ * of the value at a key path relative to an object,
+ * be notified that the value has changed.
+ * The change dictionary always contains an NSKeyValueChangeKindKey entry
+ * whose value is an NSNumber wrapping an NSKeyValueChange
+ * (use [NSNumber-intValue]). The meaning of NSKeyValueChange
+ * depends on what sort of property is identified by the key path:
+ *
+ * For any sort of property (attribute, to-one relationship,
+ * or ordered or unordered to-many relationship) NSKeyValueChangeSetting
+ * indicates that the observed object has received a -setValue:forKey:
+ * message, or that the key-value coding-compliant set method for the
+ * key has been invoked, or that a -willChangeValueForKey: or
+ * -didChangeValueForKey: pair has otherwise been invoked.
+ *
+ * For an _ordered_ to-many relationship, NSKeyValueChangeInsertion,
+ * NSKeyValueChangeRemoval, and NSKeyValueChangeReplacement indicate
+ * that a mutating message has been sent to the array returned by
+ * a -mutableArrayValueForKey: message sent to the object, or that
+ * one of the key-value coding-compliant array mutation methods for
+ * the key has been invoked, or that a -willChange:valuesAtIndexes:forKey:
+ * or -didChange:valuesAtIndexes:forKey: pair has otherwise been invoked.
+ *
+ * For an _unordered_ to-many relationship (introduced in Mac OS 10.4),
+ * NSKeyValueChangeInsertion, NSKeyValueChangeRemoval,
+ * and NSKeyValueChangeReplacement indicate that a mutating
+ * message has been sent to the set returned by a -mutableSetValueForKey:
+ * message sent to the object, or that one of the key-value
+ * coding-compliant set mutation methods for the key has been invoked,
+ * or that a -willChangeValueForKey:withSetMutation:usingObjects:
+ * or -didChangeValueForKey:withSetMutation:usingObjects: pair has
+ * otherwise been invoked.
+ *
+ * For any sort of property, the change dictionary always contains
+ * an NSKeyValueChangeNewKey entry if NSKeyValueObservingOptionNew
+ * was specified at observer-registration time, likewise for
+ * NSKeyValueChangeOldKey if NSKeyValueObservingOptionOld was specified.
+ * See the comments for the NSKeyValueObserverNotification informal
+ * protocol methods for what the values of those entries will be.
+ * For an _ordered_ to-many relationship, the change dictionary
+ * always contains an NSKeyValueChangeIndexesKey entry whose value
+ * is an NSIndexSet containing the indexes of the inserted, removed,
+ * or replaced objects, unless the change is an NSKeyValueChangeSetting.
+ * context is always the same pointer that was passed in at
+ * observer-registration time.
+ */
+
+@interface NSObject (NSKeyValueObserving)
+- (void) observeValueForKeyPath: (NSString*)aPath
+		       ofObject: (id)anObject
+			 change: (NSDictionary*)aChange
+		        context: (void*)aContext;
+
+@end
+
+@interface NSObject (NSKeyValueObserverRegistration)
+
+- (void) addObserver: (NSObject*)anObserver
+	  forKeyPath: (NSString*)aPath
+	     options: (NSKeyValueObservingOptions)options
+	     context: (void*)aContext;
+
+- (void) removeObserver: (NSObject*)anObserver
+	     forKeyPath: (NSString*)aPath;
+
+@end
+
+@interface NSArray (NSKeyValueObserverRegistration)
+
+- (void) addObserver: (NSObject*)anObserver
+  toObjectsAtIndexes: (NSIndexSet*)indexes
+	  forKeyPath: (NSString*)aPath
+	     options: (NSKeyValueObservingOptions)options
+	     context: (void*)aContext;
+
+- (void) removeObserver: (NSObject*)anObserver
+   fromObjectsAtIndexes: (NSIndexSet*)indexes
+	     forKeyPath: (NSString*)aPath;
+
+@end
+
+/**
+ * These methods are sent to the receiver when observing it active
+ * for a key and the key is about to be (or has just been) changed.
+ */
+@interface NSObject (NSKeyValueObserverNotification)
+
+- (void) didChangeValueForKey: (NSString*)aKey;
+
+- (void) didChange: (NSKeyValueChange)changeKind
+   valuesAtIndexes: (NSIndexSet*)indexes
+	    forKey: (NSString*)aKey;
+
+- (void) willChangeValueForKey: (NSString*)aKey;
+
+- (void) willChange: (NSKeyValueChange)changeKind
+    valuesAtIndexes: (NSIndexSet*)indexes
+	     forKey: (NSString*)aKey;
+
+#if OS_API_VERSION(100400,GS_API_LATEST)
+
+- (void) didChangeValueForKey: (NSString*)aKey
+	      withSetMutation: (NSKeyValueSetMutationKind)mutationKind
+		 usingObjects: (NSSet*)objects;
+
+- (void) willChangeValueForKey: (NSString*)aKey
+	       withSetMutation: (NSKeyValueSetMutationKind)mutationKind
+		  usingObjects: (NSSet*)objects;
+
+#endif
+
+@end
+
+/**
+ * These methods permit modifications to the observing system.
+ */
+@interface NSObject(NSKeyValueObservingCustomization)
+
+/**
+ * Specifies whether the class should send the notification methods of
+ * the NSKeyValueObserverNotification protocol when instances of the
+ * class receive messages to change the value for the key.<br />
+ * The default implementation returns YES.
+ */
++ (BOOL) automaticallyNotifiesObserversForKey: (NSString*)aKey;
+
+/**
+ * Tells the observing system that when NSKeyValueObserverNotification
+ * protocol messages are sent for any key in the keys array, they should
+ * also be sent for dependentKey.
+ */
++ (void) setKeys: (NSArray*)keys
+triggerChangeNotificationsForDependentKey: (NSString*)dependentKey;
+
+/**
+ * Returns a reference to the observation information for the receiver
+ * as stored using the -setObservationInfo: method.<br />
+ * The default implementation returns information from a global table.
+ */
+- (void*) observationInfo;
+
+/**
+ * Stores observation information for the receiver.  By default this is
+ * done in a global table, but classes may implement storage in an instance
+ * variable or some other scheme (for improved performance).
+ */
+- (void) setObservationInfo: (void*)observationInfo;
+
+@end
+
+#endif
+#endif /* __NSKeyValueObserving_h_GNUSTEP_BASE_INCLUDE */
+