| java.lang.Object
 com.sun.midp.lcdui.DisplayEventProducer
| DisplayEventProducer | | public class DisplayEventProducer (Code) | | This class provides methods to send events of types
handled by MDisplayEventConsumer I/F implementors.
This class completely hide event construction & sending in its methods.
Generic comments for all XXXEventProducers:
For each supported event type there is a separate sendXXXEvent() method,
that gets all needed parameters to construct an event of an approprate class.
The method also performs event sending itself.
If a given event type merges a set of logically different subtypes,
this class shall provide separate methods for these subtypes.
It is assumed that only one object instance of this class
is initialized with the system event that is created at (isolate) startup.
This class only operates on the event queue given to it during
construction, the class does not obtain any restricted object itself,
so it does not need protection.
All MIDP stack subsystems that need to send events of supported types,
must get a reference to an already created istance of this class.
Typically, this instance should be passed as a constructor parameter.
Class is NOT final to allow debug/profile/test/automation subsystems
to change, substitute, complement default "event sending" functionality :
Ex.
class LogXXXEventProducer
extends XXXEventProducer {
...
void sendXXXEvent(parameters) {
LOG("Event of type XXX is about to be sent ...")
super.sendXXXEvent(parameters);
LOG("Event of type XXX has been sent successfully !")
}
...
}
|
| Constructor Summary | |
| public | DisplayEventProducer(EventQueue theEventQueue)
Construct a new DisplayEventProducer. |
| DisplayEventProducer | | public DisplayEventProducer(EventQueue theEventQueue)(Code) | | Construct a new DisplayEventProducer.
Parameters:
theEventQueue - An event queue where new events will be posted. |
| sendCallSeriallyEvent | | public void sendCallSeriallyEvent(DisplayEventConsumer d)(Code) | | Called to schedule a serial callback of a Runnable object passed
into Display's callSerially() method.
Parameters:
d - The Display |
| sendInvalidateEvent | | public void sendInvalidateEvent(DisplayEventConsumer d)(Code) | | Called to schedule an invalidation of a Form.
Parameters:
d - The Display |
| sendItemSizeRefreshEvent | | public void sendItemSizeRefreshEvent(CustomItem src)(Code) | | Schedules a call requesting a CustomItem to refresh its sizes.
Parameters:
src - the CustomItem requested to be refreshed |
| sendItemStateChangeEvent | | public void sendItemStateChangeEvent(Item src)(Code) | | Schedules a call to an ItemStateListener.
Parameters:
src - the Item which has changed, this parameter is need onlyby Form however, this means that events cannot be merged.If Form was to scan its itemsfor invalid ones in callItemStateChanged, only one of these eventswould need to be in the queue at once. |
| sendScreenChangeEvent | | public void sendScreenChangeEvent(DisplayEventConsumer parent, Displayable d)(Code) | | Called to schedule a screen change to the given Displayable
as soon as possible
Parameters:
parent - parent Display of the Displayable
Parameters:
d - The Displayable to change to |
| sendScreenRepaintEvent | | public void sendScreenRepaintEvent(DisplayEventConsumer d)(Code) | | Schedules a call to repaint entire screen content.
Parameters:
d - The Display |
|
|