Server : Apache/2.4.41 (Ubuntu) System : Linux absol.cf 5.4.0-198-generic #218-Ubuntu SMP Fri Sep 27 20:18:53 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory : /usr/share/doc/gnustep-base-doc/Base/Reference/
Upload File :
Current File : //usr/share/doc/gnustep-base-doc/Base/Reference/NSKeyValueObserving.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>NSKeyValueObserving documentation</title>
</head>
<body>
<font face="serif">
<a href="Base.html">Up</a>
<br />
<h1><a name="title$NSKeyValueObserving">NSKeyValueObserving documentation</a></h1>
<h3>Authors</h3>
<dl>
<dt>Generated by Debian</dt>
<dd>
</dd>
</dl>
<p><b>Copyright:</b> (C) 2005 Free Software Foundation, Inc.</p>
<div>
<hr width="50%" align="left" />
<h3>Contents -</h3>
<ol>
<li>
<a href="#001000000000">Software documentation for the
NSArray(NSKeyValueObserverRegistration)
category</a>
</li>
<li>
<a href="#002000000000">Software documentation for the
NSObject(NSKeyValueObserverNotification)
category</a>
</li>
<li>
<a href="#003000000000">Software documentation for the
NSObject(NSKeyValueObserverRegistration)
category</a>
</li>
<li>
<a href="#004000000000">Software documentation for the
NSObject(NSKeyValueObserving)
category</a>
</li>
<li>
<a href="#005000000000">Software documentation for the
NSObject(NSKeyValueObservingCustomization)
category</a>
</li>
</ol>
<hr width="50%" align="left" />
</div>
<h1><a name="001000000000">
Software documentation for the
NSArray(NSKeyValueObserverRegistration)
category
</a></h1>
<h2><a rel="gsdoc" href="NSArray.html#class$NSArray">NSArray</a>(<a name="category$NSArray(NSKeyValueObserverRegistration)">NSKeyValueObserverRegistration</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>Foundation/NSKeyValueObserving.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
NSArray objects are not observable, so the
registration methods raise an exception.
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSArray(NSKeyValueObserverRegistration)-addObserver$toObjectsAtIndexes$forKeyPath$options$context$">-addObserver:toObjectsAtIndexes:forKeyPath:options:context:</a></li>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSArray(NSKeyValueObserverRegistration)-removeObserver$fromObjectsAtIndexes$forKeyPath$">-removeObserver:fromObjectsAtIndexes:forKeyPath:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSArray(NSKeyValueObserverRegistration)-addObserver$toObjectsAtIndexes$forKeyPath$options$context$">addObserver: toObjectsAtIndexes: forKeyPath: options: context: </a></h3>
- (void) <b>addObserver:</b> (<a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a>*)anObserver<b> toObjectsAtIndexes:</b> (<a rel="gsdoc" href="NSIndexSet.html#class$NSIndexSet">NSIndexSet</a>*)indexes<b> forKeyPath:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aPath<b> options:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSKeyValueObservingOptions">NSKeyValueObservingOptions</a>)options<b> context:</b> (void*)aContext;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSArray(NSKeyValueObserverRegistration)-removeObserver$fromObjectsAtIndexes$forKeyPath$">removeObserver: fromObjectsAtIndexes: forKeyPath: </a></h3>
- (void) <b>removeObserver:</b> (<a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a>*)anObserver<b> fromObjectsAtIndexes:</b> (<a rel="gsdoc" href="NSIndexSet.html#class$NSIndexSet">NSIndexSet</a>*)indexes<b> forKeyPath:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aPath;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<h1><a name="002000000000">
Software documentation for the
NSObject(NSKeyValueObserverNotification)
category
</a></h1>
<h2><a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a>(<a name="category$NSObject(NSKeyValueObserverNotification)">NSKeyValueObserverNotification</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>Foundation/NSKeyValueObserving.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
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.
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObserverNotification)-didChange$valuesAtIndexes$forKey$">-didChange:valuesAtIndexes:forKey:</a></li>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObserverNotification)-didChangeValueForKey$">-didChangeValueForKey:</a></li>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObserverNotification)-didChangeValueForKey$withSetMutation$usingObjects$">-didChangeValueForKey:withSetMutation:usingObjects:</a></li>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObserverNotification)-willChange$valuesAtIndexes$forKey$">-willChange:valuesAtIndexes:forKey:</a></li>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObserverNotification)-willChangeValueForKey$">-willChangeValueForKey:</a></li>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObserverNotification)-willChangeValueForKey$withSetMutation$usingObjects$">-willChangeValueForKey:withSetMutation:usingObjects:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObserverNotification)-didChange$valuesAtIndexes$forKey$">didChange: valuesAtIndexes: forKey: </a></h3>
- (void) <b>didChange:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSKeyValueChange">NSKeyValueChange</a>)changeKind<b> valuesAtIndexes:</b> (<a rel="gsdoc" href="NSIndexSet.html#class$NSIndexSet">NSIndexSet</a>*)indexes<b> forKey:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aKey;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
An empty method provided for subclasses to override.<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObserverNotification)-didChangeValueForKey$">didChangeValueForKey: </a></h3>
- (void) <b>didChangeValueForKey:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aKey;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
An empty method provided for subclasses to override.<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObserverNotification)-didChangeValueForKey$withSetMutation$usingObjects$">didChangeValueForKey: withSetMutation: usingObjects: </a></h3>
- (void) <b>didChangeValueForKey:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aKey<b> withSetMutation:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSKeyValueSetMutationKind">NSKeyValueSetMutationKind</a>)mutationKind<b> usingObjects:</b> (<a rel="gsdoc" href="NSSet.html#class$NSSet">NSSet</a>*)objects;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.4.0, Base 1.2.0</div>
<br />
An empty method provided for subclasses to override.<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObserverNotification)-willChange$valuesAtIndexes$forKey$">willChange: valuesAtIndexes: forKey: </a></h3>
- (void) <b>willChange:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSKeyValueChange">NSKeyValueChange</a>)changeKind<b> valuesAtIndexes:</b> (<a rel="gsdoc" href="NSIndexSet.html#class$NSIndexSet">NSIndexSet</a>*)indexes<b> forKey:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aKey;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
An empty method provided for subclasses to override.<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObserverNotification)-willChangeValueForKey$">willChangeValueForKey: </a></h3>
- (void) <b>willChangeValueForKey:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aKey;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
An empty method provided for subclasses to override.<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObserverNotification)-willChangeValueForKey$withSetMutation$usingObjects$">willChangeValueForKey: withSetMutation: usingObjects: </a></h3>
- (void) <b>willChangeValueForKey:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aKey<b> withSetMutation:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSKeyValueSetMutationKind">NSKeyValueSetMutationKind</a>)mutationKind<b> usingObjects:</b> (<a rel="gsdoc" href="NSSet.html#class$NSSet">NSSet</a>*)objects;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.4.0, Base 1.2.0</div>
<br />
An empty method provided for subclasses to override.<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<h1><a name="003000000000">
Software documentation for the
NSObject(NSKeyValueObserverRegistration)
category
</a></h1>
<h2><a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a>(<a name="category$NSObject(NSKeyValueObserverRegistration)">NSKeyValueObserverRegistration</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>Foundation/NSKeyValueObserving.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObserverRegistration)-addObserver$forKeyPath$options$context$">-addObserver:forKeyPath:options:context:</a></li>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObserverRegistration)-removeObserver$forKeyPath$">-removeObserver:forKeyPath:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObserverRegistration)-addObserver$forKeyPath$options$context$">addObserver: forKeyPath: options: context: </a></h3>
- (void) <b>addObserver:</b> (<a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a>*)anObserver<b> forKeyPath:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aPath<b> options:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSKeyValueObservingOptions">NSKeyValueObservingOptions</a>)options<b> context:</b> (void*)aContext;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObserverRegistration)-removeObserver$forKeyPath$">removeObserver: forKeyPath: </a></h3>
- (void) <b>removeObserver:</b> (<a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a>*)anObserver<b> forKeyPath:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aPath;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<h1><a name="004000000000">
Software documentation for the
NSObject(NSKeyValueObserving)
category
</a></h1>
<h2><a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a>(<a name="category$NSObject(NSKeyValueObserving)">NSKeyValueObserving</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>Foundation/NSKeyValueObserving.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObserving)-observeValueForKeyPath$ofObject$change$context$">-observeValueForKeyPath:ofObject:change:context:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObserving)-observeValueForKeyPath$ofObject$change$context$">observeValueForKeyPath: ofObject: change: context: </a></h3>
- (void) <b>observeValueForKeyPath:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aPath<b> ofObject:</b> (id)anObject<b> change:</b> (<a rel="gsdoc" href="NSDictionary.html#class$NSDictionary">NSDictionary</a>*)aChange<b> context:</b> (void*)aContext;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<h1><a name="005000000000">
Software documentation for the
NSObject(NSKeyValueObservingCustomization)
category
</a></h1>
<h2><a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a>(<a name="category$NSObject(NSKeyValueObservingCustomization)">NSKeyValueObservingCustomization</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>Foundation/NSKeyValueObserving.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
These methods permit modifications to the observing
system.
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObservingCustomization)+automaticallyNotifiesObserversForKey$">+automaticallyNotifiesObserversForKey:</a></li>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObservingCustomization)+keyPathsForValuesAffectingValueForKey$">+keyPathsForValuesAffectingValueForKey:</a></li>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObservingCustomization)+setKeys$triggerChangeNotificationsForDependentKey$">+setKeys:triggerChangeNotificationsForDependentKey:</a></li>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObservingCustomization)-observationInfo">-observationInfo</a></li>
<li><a rel="gsdoc" href="NSKeyValueObserving.html#method$NSObject(NSKeyValueObservingCustomization)-setObservationInfo$">-setObservationInfo:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObservingCustomization)+automaticallyNotifiesObserversForKey$">automaticallyNotifiesObserversForKey: </a></h3>
+ (BOOL) <b>automaticallyNotifiesObserversForKey:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)aKey;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
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 <code>YES</code>.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObservingCustomization)+keyPathsForValuesAffectingValueForKey$">keyPathsForValuesAffectingValueForKey: </a></h3>
+ (<a rel="gsdoc" href="NSSet.html#class$NSSet">NSSet</a>*) <b>keyPathsForValuesAffectingValueForKey:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)dependentKey;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.5.0, Base 1.2.0</div>
<br />
<div class="desc">
Returns a set of key paths for properties whose
values affect the value of the specified
<var>dependentKey</var>.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObservingCustomization)+setKeys$triggerChangeNotificationsForDependentKey$">setKeys: triggerChangeNotificationsForDependentKey: </a></h3>
+ (void) <b>setKeys:</b> (<a rel="gsdoc" href="NSArray.html#class$NSArray">NSArray</a>*)triggerKeys<b> triggerChangeNotificationsForDependentKey:</b> (<a rel="gsdoc" href="NSString.html#class$NSString">NSString</a>*)dependentKey;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
Tells the observing system that when
NSKeyValueObserverNotification
protocol messages are sent for any key in the
<var>triggerKeys</var> array, they should also be
sent for <var>dependentKey</var>.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObservingCustomization)-observationInfo">observationInfo </a></h3>
- (void*) <b>observationInfo</b>;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
Returns a reference to the observation information
for the receiver as stored using the
<a rel="gsdoc" href="#method$NSObject(NSKeyValueObservingCustomization)-setObservationInfo$">
-setObservationInfo:
</a>
method. <br /> The default implementation returns
information from a global table.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSKeyValueObservingCustomization)-setObservationInfo$">setObservationInfo: </a></h3>
- (void) <b>setObservationInfo:</b> (void*)observationInfo;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0, Base 1.2.0</div>
<br />
<div class="desc">
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).
</div>
<hr width="25%" align="left" />
</div>
<br />
<a href="Base.html">Up</a>
</font>
</body>
</html>
Server : Apache/2.4.41 (Ubuntu)