mccallum@gnu.ai.mit.edu
)richard@brainstorm.co.uk
)Version: 1.113
Date: 2004/06/10 19:39:32
Copyright: (C) 1996-1999 Free Software Foundation, Inc.
- Declared in:
- Foundation/NSRunLoop.h
- Conforms to:
- GCFinalization
Standards:
- MacOS-X
- OpenStep
- GNUstep
Description forthcoming.
Method summaryDescription forthcoming.
Listen for events from input sources.
If
limit_date is nil
or in the
past, then don't wait; just poll inputs and return,
otherwise block until input is available or until
the earliest limit date has passed (whichever comes
first).
If the supplied mode is
nil
, uses NSDefaultRunLoopMode.
Adds a timer to the loop in the specified
mode.
Timers are removed
automatically when they are invalid.
Returns the current mode of this runloop. If the
runloop is not running then this method returns
nil
.
Fires timers whose fire date has passed, and checks timers and limit dates for input sources, determining the earliest time that anything watched for becomes useless. Returns that date/time.
Description forthcoming.
Calls
-acceptInputForMode:beforeDate:
to run the loop once.
The specified
date may be nil
... in which
case the loop runs until the limit date of
the first input or timeout.
If the specified
date is in the past, runs the loop once
only, to handle any events already available.
If there are no input sources in mode,
returns NO
without running the loop,
otherwise returns YES
.
Description forthcoming.
- Declared in:
- Foundation/NSRunLoop.h
Standards:
- MacOS-X
- OpenStep
- GNUstep
Description forthcoming.
Method summaryDescription forthcoming.
- Declared in:
- Foundation/NSRunLoop.h
Standards:
- MacOS-X
- OpenStep
- GNUstep
These are general purpose methods for letting objects ask the runloop to watch for events for them. Only one object at a time may be watching for a particular event in a mode, but that object may add itsself as a watcher many times as long as each addition is matched by a removal (the run loop keeps count). Alternatively, the 'removeAll' parameter may be set to 'YES' for [-removeEvent:type:forMode:all:] in order to remove the watcher irrespective of the number of times it has been added.
Method summary
Adds a runloop watcher matching the
specified data and type in
this runloop. If the mode is
nil
, either the
-currentMode
is used (if the loop is running) or NSDefaultRunLoopMode
is used.
NB. The watcher is
not retained by the run loop and must be
removed from the loop before deallocation...
otherwise the loop might try to send a message to
the deallocated watcher object resulting in
a crash. You use
-removeEvent:type:forMode:all:
to do this.
Removes a runloop watcher matching the specified
data and type in this runloop.
If the mode is nil
, either the
-currentMode
is used (if the loop is running) or NSDefaultRunLoopMode
is used.
The additional removeAll flag
may be used to remove all instances of the watcher
rather than just a single one.
- Declared in:
- Foundation/NSRunLoop.h
Standards:
- MacOS-X
- OpenStep
- GNUstep
Description forthcoming.
Method summaryDescription forthcoming.
Cancels any perform operations set up for the
specified target in the receiver, but
only if the value of aSelector and
argument with which the performs were set
up match those supplied.
Matching of the
argument may be either by pointer equality
or by use of the
[NSObject -isEqual:]
method.
Cancels any perform operations set up for the specified target in the receiver.
Description forthcoming.
Sets up sending of aSelector to
target with argument.
The selector is sent before the next runloop iteration
(unless cancelled before then).
The
target and argument objects are
not retained.
The order
value is used to determine the order in
which messages are sent if multiple messages have
been set up. Messages with a lower order
value are sent first.
Description forthcoming.
- Declared in:
- Foundation/NSRunLoop.h
Standards:
- MacOS-X
- OpenStep
- GNUstep
This protocol documents the callback messages that an object receives if it has registered to receive run loop events using [NSRunLoop -addEvent:type:watcher:forMode:]
Method summaryCallback message sent to object when the event it it waiting for occurs. The 'data' and 'type' valueds are those passed in the original addEvent:type:watcher:forMode: method. The 'extra' value may be additional data returned depending on the type of event.
Callback message sent to object waiting for an event in the runloop when the limit-date for the operation is reached. If an NSDate object is returned, the operation is restarted with the new limit-date, otherwise it is removed from the run loop.