|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.util.EventObject
java.awt.AWTEvent
java.awt.event.InvocationEvent
public class InvocationEvent
An event which executes the run()
method on a Runnable
when dispatched by the AWT event dispatcher thread. This class can
be used as a reference implementation of ActiveEvent
rather
than declaring a new class and defining dispatch()
.
Instances of this class are placed on the EventQueue
by calls
to invokeLater
and invokeAndWait
. Client code
can use this fact to write replacement functions for invokeLater
and invokeAndWait
without writing special-case code
in any AWTEventListener
objects.
Note: The timestamps used by this class report the difference,
measured in milliseconds, between the time of the event and midnight,
January 1, 1970 UTC
(similar to System.currentTimeMillis
).
ActiveEvent
,
EventQueue.invokeLater(java.lang.Runnable)
,
EventQueue.invokeAndWait(java.lang.Runnable)
,
AWTEventListener
,
Serialized FormField Summary | |
---|---|
static int |
INVOCATION_DEFAULT
The default id for all InvocationEvents. |
static int |
INVOCATION_FIRST
Marks the first integer id for the range of invocation event ids. |
static int |
INVOCATION_LAST
Marks the last integer id for the range of invocation event ids. |
Constructor Summary | |
---|---|
InvocationEvent(Object source,
Runnable runnable)
Constructs an InvocationEvent with the specified
source which will execute the runnable's run
method when dispatched. |
|
InvocationEvent(Object source,
Runnable runnable,
Object notifier,
boolean catchExceptions)
Constructs an InvocationEvent with the specified
source which will execute the runnable's run
method when dispatched. |
Method Summary | |
---|---|
void |
dispatch()
Executes the Runnable's run() method and notifies the
notifier (if any) when run() returns. |
Exception |
getException()
Returns any Exception caught while executing the Runnable's run()
method. |
long |
getWhen()
Returns the timestamp of when this event occurred. |
String |
paramString()
Returns a parameter string identifying this event. |
Methods inherited from class java.awt.AWTEvent |
---|
getID, toString |
Methods inherited from class java.util.EventObject |
---|
getSource |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final int INVOCATION_FIRST
public static final int INVOCATION_DEFAULT
public static final int INVOCATION_LAST
Constructor Detail |
---|
public InvocationEvent(Object source, Runnable runnable)
InvocationEvent
with the specified
source which will execute the runnable's run
method when dispatched.
source
- the Object
that originated the eventrunnable
- the Runnable
whose run
method will be executedpublic InvocationEvent(Object source, Runnable runnable, Object notifier, boolean catchExceptions)
InvocationEvent
with the specified
source which will execute the runnable's run
method when dispatched. If notifier is non-null
,
notifyAll()
will be called on it
immediately after run
returns.
source
- the Object
that originated
the eventrunnable
- the Runnable
whose
run
method will be
executednotifier
- the Object whose notifyAll
method will be called after
Runnable.run
has returnedcatchExceptions
- specifies whether dispatch
should catch Exception when executing
the Runnable
's run
method, or should instead propagate those
Exceptions to the EventDispatchThread's
dispatch loopMethod Detail |
---|
public void dispatch()
run()
method and notifies the
notifier (if any) when run()
returns.
dispatch
in interface ActiveEvent
public Exception getException()
run()
method.
public long getWhen()
public String paramString()
paramString
in class AWTEvent
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |