Up
Authors
- Andrew Kachites McCallum (
mccallum@gnu.ai.mit.edu
)
-
- Richard Frith-Macdonald (
rfm@gnu.org
)
-
Version: 27564
Date: 2009-01-09 09:23:40 +0000 (Fri, 09 Jan 2009)
Copyright: (C) 1995, 1996, 1999 Free Software Foundation, Inc.
- Declared in:
- Foundation/NSTimer.h
Availability: OpenStep
An
NSTimer
provides a way to send a message
at some time in the future, possibly repeating every time
a fixed interval has passed. To use a timer, you can either
create one that will automatically be added to the run
loop in the current thread (using the
-addTimer:forMode:
method), or you can create it without adding it then
add it to an
NSRunLoop
explicitly later.
Method summary
+ (
NSTimer*)
scheduledTimerWithTimeInterval: (
NSTimeInterval)ti
invocation: (
NSInvocation*)invocation
repeats: (BOOL)f;
Availability: OpenStep
Create a timer which will fire after ti
seconds and, if f is YES
,
every ti seconds thereafter. On firing,
invocation will be performed.
This
timer will automatically be added to the current run
loop and will fire in the default run loop mode.
+ (
NSTimer*)
scheduledTimerWithTimeInterval: (
NSTimeInterval)ti
target: (id)object
selector: (SEL)selector
userInfo: (id)info
repeats: (BOOL)f;
Availability: OpenStep
Create a timer which will fire after ti
seconds and, if f is YES
,
every ti seconds thereafter. On firing,
the target object will be sent a message
specified by selector and with the
timer as its argument.
This timer will
automatically be added to the current run
loop and will fire in the default run loop mode.
+ (
NSTimer*)
timerWithTimeInterval: (
NSTimeInterval)ti
invocation: (
NSInvocation*)invocation
repeats: (BOOL)f;
Availability: OpenStep
Create a timer which will fire after ti
seconds and, if f is YES
,
every ti seconds thereafter. On firing,
invocation will be performed.
NB.
To make the timer operate, you must add it to a run
loop.
+ (
NSTimer*)
timerWithTimeInterval: (
NSTimeInterval)ti
target: (id)object
selector: (SEL)selector
userInfo: (id)info
repeats: (BOOL)f;
Availability: OpenStep
Create a timer which will fire after ti
seconds and, if f is YES
,
every ti seconds thereafter. On firing,
the target object will be sent a message
specified by selector and with the
timer as its argument.
NB. To make the timer
operate, you must add it to a run loop.
- (void)
fire;
Availability: OpenStep
Fires the timer... either performs an invocation or
sends a message to a target object, depending on how
the timer was set up.
If the timer is not set to
repeat, it is automatically invalidated.
Exceptions raised during firing of the timer are
caught and logged.
- (
NSDate*)
fireDate;
Availability: OpenStep
Returns the date/time at which the timer is next
due to fire.
- (id)
initWithFireDate: (
NSDate*)fd
interval: (
NSTimeInterval)ti
target: (id)object
selector: (SEL)selector
userInfo: (id)info
repeats: (BOOL)f;
Availability: MacOS-X 10.2.0
This is a designated initialiser for the class.
Initialise the receive, a newly allocated
NSTimer object.
The fd
argument specifies an initial fire date... if it
is not supplied (a nil
object)
then the ti argument is used to create a
start date relative to the current time.
The
ti argument specifies the time (in
seconds) between the firing. If it is less than or
equal to 0.0 then a small interval is chosen
automatically.
The f
argument specifies whether the timer will fire
repeatedly or just once.
If the
selector argument is zero, then then
object is an invocation to be used when
the timer fires. otherwise, the object is
sent the message specified by the selector
and with the timer as an argument.
The
fd, object and info
arguments will be retained until the timer is
invalidated.
- (void)
invalidate;
Availability: OpenStep
Marks the timer as invalid, causing its
target/invocation and user info objects
to be released.
Invalidated timers are
automatically removed from the run loop when
it detects them.
- (BOOL)
isValid;
Availability: MacOS-X 10.0.0
Checks to see if the timer has been invalidated.
- (void)
setFireDate: (
NSDate*)fireDate;
Availability: MacOS-X 10.2.0
Change the fire date for the receiver.
NB.
You should NOT use this method for a timer
which has been added to a run loop. The only time
when it is safe to modify the fire date of a timer in
a run loop is for a repeating timer when the timer is
actually in the process of firing.
- (
NSTimeInterval)
timeInterval;
Availability: MacOS-X 10.0.0
Returns the interval between firings, or zero if
the timer does not repeat.
- (id)
userInfo;
Availability: OpenStep
Returns the user info which was set for the timer
when it was created, or nil
if none was
set or the timer is invalid.
Up