|
JavaTM 2 Platform Std. Ed. v1.4.2 |
||||||||||
| 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
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.
ActiveEvent,
EventQueue.invokeLater(java.lang.Runnable),
EventQueue.invokeAndWait(java.lang.Runnable),
AWTEventListener,
Serialized Form| Field Summary | |
protected boolean |
catchExceptions
Set to true if dispatch() catches Exception and stores it in the exception instance variable. |
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. |
protected Object |
notifier
The (potentially null) Object whose notifyAll() method will be called immediately after the Runnable.run() method returns. |
protected Runnable |
runnable
The Runnable whose run() method will be called. |
| Fields inherited from class java.util.EventObject |
source |
| Constructor Summary | |
protected |
InvocationEvent(Object source,
int id,
Runnable runnable,
Object notifier,
boolean catchExceptions)
Constructs an InvocationEvent with the specified
source and ID which will execute the runnable's run
method when dispatched. |
|
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 |
consume, getID, isConsumed, setSource, toString |
| Methods inherited from class java.util.EventObject |
getSource |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, 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
protected Runnable runnable
protected Object notifier
protected boolean catchExceptions
| 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 executed
public 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 loop
protected InvocationEvent(Object source,
int id,
Runnable runnable,
Object notifier,
boolean catchExceptions)
InvocationEvent with the specified
source and ID 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.
Note that passing in an invalid id results in
unspecified behavior.
source - the Object that originated
the eventid - the ID for 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 loop| Method Detail |
public void dispatch()
run() method and notifies the
notifier (if any) when run() returns.
dispatch in interface ActiveEventpublic Exception getException()
run()
method.
public long getWhen()
public String paramString()
paramString in class AWTEvent
|
JavaTM 2 Platform Std. Ed. v1.4.2 |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.