| java.lang.Object
 com.sun.midp.main.DisplayController
All known Subclasses: com.sun.midp.main.AutoDisplayController, com.sun.midp.main.SMMDisplayController, com.sun.midp.main.MVMDisplayController,
| DisplayController | | class DisplayController (Code) | | This class controls which MIDlet's display is in the foreground.
Running only in the AMS Isolate (0) the controller consulted by the MIDlet
proxy list for any foreground when various state changes occur in a MIDlet.
The display controller automatically selects the next foreground if
needed.
From the user perspective when the last MIDlet the user launched sets its
current displayable for the first time, that MIDlet should automatically
get the foreground (see the midletCreated and foregroundRequest methods).
A MIDlet that is paused or destroyed is treated as if it has requested the
background as described above.
|
| lastMidletCreated | | protected MIDletProxy lastMidletCreated(Code) | | The last MIDlet added to the MIDlet proxy list, but has not requested
to be in the foreground.
|
| DisplayController | | protected DisplayController(MIDletProxyList theMIDletProxyList)(Code) | | Construct a DisplayController with a reference to the ProxyList.
Parameters:
theMIDletProxyList - reference to the MIDlet proxy list |
| backgroundRequest | | MIDletProxy backgroundRequest(MIDletProxy midlet)(Code) | | Handles MIDlet background requests.
If the MIDlet is requesting to be put in the background is the
foreground MIDlet, then find a MIDlet to bring to the foreground
(see the findNextForeground method).
Parameters:
midlet - The proxy of the MIDlet that was updated Proxy of the next foreground MIDlet, may be the foregroundMIDlet if the foreground should not change |
| endPreempting | | MIDletProxy endPreempting(int isolateId, int displayId)(Code) | | End the preempt an Isolate's displays.
Parameters:
isolateId - isolate ID of display that done preempting
Parameters:
displayId - display ID of display that done preempting Proxy of the next foreground MIDlet, may be the foregroundMIDlet if the foreground should not change |
| foregroundMidletChanging | | MIDletProxy foregroundMidletChanging(MIDletProxy midlet)(Code) | | Call to notify that foreground MIDlet is changing and give the
display controller a chance to preempt the change.
Also the last MIDlet created state will be reset.
If the MIDlet to get the foreground is paused, then activate it.
Parameters:
midlet - proxy of the MIDlet to be put in the foreground Proxy of the next foreground MIDlet, may be the foregroundMIDlet if the foreground should not change |
| foregroundRequest | | MIDletProxy foregroundRequest(MIDletProxy midlet)(Code) | | Handles MIDlet foreground requests.
If proxy being updated belongs last MIDlet created in the proxy list,
then put the MIDlet in the foreground.
If there is no foreground MIDlet or the foreground MIDlet does not
want the foreground or the foreground MIDlet is paused, then put the
MIDlet in the foreground.
Parameters:
midlet - The proxy of the MIDlet that was updated Proxy of the next foreground MIDlet, may be the foregroundMIDlet if the foreground should not change |
| midletActive | | MIDletProxy midletActive(MIDletProxy midlet)(Code) | | Called when a MIDlet is move to active state.
Parameters:
midlet - The proxy of the MIDlet being activated Proxy of the next foreground MIDlet, may be the foregroundMIDlet if the foreground should not change |
| midletCreated | | void midletCreated(MIDletProxy midlet)(Code) | | Update the last MIDlet created field so when the wantsForeground
field of the MIDletProxy is updated to be true, the MIDlet can
be automatically put into the foreground.
Called when a MIDlet is created to the proxy list.
Parameters:
midlet - The proxy of the MIDlet being created |
| midletDestroyed | | MIDletProxy midletDestroyed(MIDletProxy midlet)(Code) | | If the removed MIDlet is the foreground MIDlet find a new
foreground MIDlet. After clearing the last midlet created, treat this
state change as background request.
Called when a MIDlet is removed from the proxy list.
Parameters:
midlet - The proxy of the removed MIDlet Proxy of the next foreground MIDlet, may be the foregroundMIDlet if the foreground should not change |
| midletPaused | | MIDletProxy midletPaused(MIDletProxy midlet)(Code) | | Handles any possible foreground changes due the state of a MIDlet
changing to paused.
Treat this state change as a background request.
Called when the state of a MIDlet in the MIDlet proxy list is paused.
Parameters:
midlet - The proxy of the MIDlet that was updated Proxy of the next foreground MIDlet, may be the foregroundMIDlet if the foreground should not change |
| notifyListenersOfSelectForeground | | void notifyListenersOfSelectForeground(boolean onlyFromLaunchedList)(Code) | | Notify the listeners of the display controller that foreground
selection ui should be launched.
Parameters:
onlyFromLaunchedList - true if midlet shouldbe selected from the list of already launched midlets,if false then possibility to launch midlet is needed. |
| removeListener | | public void removeListener(DisplayControllerListener listener)(Code) | | Remove a listener for DisplayController.
Parameters:
listener - DisplayController listener |
| selectForeground | | MIDletProxy selectForeground(boolean onlyFromLaunchedList)(Code) | | Called to process a select foreground event. Processing this event
only needs to be done when application MIDlets are allowed to run
concurrently. In SVM mode the display controller returns
foreground MIDlet.
Parameters:
onlyFromLaunchedList - true if midlet shouldbe selected from the list of already launched midlets,if false then possibility to launch midlet is needed. Proxy of the next foreground MIDlet, may be the foregroundMIDlet if the foreground should not change |
| startPreempting | | MIDletProxy startPreempting(MIDletProxy preempting)(Code) | | Called to process a preempt event. The default is to preempt the
foreground.
Parameters:
preempting - proxy of the preempting MIDlet to be put in theforeground when a preempted MIDlet gets the foreground or to beput in the foreground directly. Proxy of the next foreground MIDlet, may be the foregroundMIDlet if the foreground should not change |
| transferRequest | | MIDletProxy transferRequest(MIDletProxy origin, MIDletProxy target)(Code) | | Request a transfer of the foreground from one MIDlet to another.
The transfer only succeeds if the current foreground is the "from"
MIDlet.
Parameters:
origin - the MIDletProxy from which the FG should transfer from
Parameters:
target - the MIDletProxy to which the FG should transfer to the choice about which to become the FG |
|
|