| javax.microedition.lcdui.DisplayableLF
All known Subclasses: javax.microedition.lcdui.DisplayableLFImpl,
| DisplayableLF | | interface DisplayableLF (Code) | | Look and Feel interface used by Displayable.
See Naming Conventions
for information about method naming conventions.
|
| Method Summary | |
| int | getVerticalScrollPosition()
| | int | getVerticalScrollProportion()
| | void | lAddCommand(Command cmd, int i)
Notifies look&feel object of a command addition
to the Displayable. | | void | lCommitPendingInteraction()
Called to commit any pending user interaction for the current
item before an abstract command is fired. | | Display | lGetCurrentDisplay()
Return in which Display instance the LF is visible. | | Displayable | lGetDisplayable()
Return the associated Displayable object. | | int | lGetHeight()
Returns the height of the area available to the application. | | int | lGetWidth()
Returns the width of the area available to the application. | | boolean | lIsShown()
Implement the public API isShown(). | | void | lRemoveCommand(Command cmd, int i)
Notifies look&feel object of a command removal
from the Displayable. | | void | lSetDisplay(Display d)
Set the display instance the Displayable is associated with. | | void | lSetTicker(Ticker oldTicker, Ticker newTicker)
Notifies Displayable's look & feel object of a ticker change. | | void | lSetTitle(String oldTitle, String newTitle)
Notifies Displayable's look & feel object of a title change. | | void | uCallFreeze()
While UI resources of this LF are created and visible already, stop any
further updates to physical screen because some "system modal dialog"
takes over physical screen buffer and user input now.
Repaint and invalidate requests from this DisplayableLF will be really
scheduled into event queue. | | void | uCallHide()
Remove this displayable from physical screen.
The displayable should unload any resource that was allocated. | | void | uCallInvalidate()
Relayout and repaint now. | | void | uCallKeyEvent(int type, int keyCode)
Handle key events. | | void | uCallPaint(Graphics g, Object target)
Repaint now. | | void | uCallPointerEvent(int type, int x, int y)
Handle pointer events. | | void | uCallScrollContent(int scrollType, int thumbPosition)
| | void | uCallShow()
Prepare to show this LF on physical screen. | | void | uCallSizeChanged(int w, int h)
This method calls Displayable.sizeChanged method. | | boolean | uIsScrollNative()
This method is used int repaint, int order to determine the
translation of the draw coordinates.
true if the scroll responsibility is of the native platform.false - if the scroll is done in the Java level. | | void | uSetFullScreenMode(boolean fullScreenMode)
Notify the full screen mode of this LF.
If true, this DisplayableLF will take up as much screen
real estate as possible. | | boolean | uSetRotatedStatus(boolean newStatus)
| | void | updateCommandSet()
Notifies look&feel object of commandset being updated. |
| getVerticalScrollPosition | | int getVerticalScrollPosition()(Code) | | Get the current vertical scroll position
int The vertical scroll position on a scale of 0-100 |
| getVerticalScrollProportion | | int getVerticalScrollProportion()(Code) | | Get the current vertical scroll proportion
ing The vertical scroll proportion on a scale of 0-100 |
| lAddCommand | | void lAddCommand(Command cmd, int i)(Code) | | Notifies look&feel object of a command addition
to the Displayable.
Parameters:
cmd - the command that was added
Parameters:
i - the index of the added command in Displayable.commands[] array |
| lCommitPendingInteraction | | void lCommitPendingInteraction()(Code) | | Called to commit any pending user interaction for the current
item before an abstract command is fired.
Caller should hold LCDUILock around this call.
|
| lGetCurrentDisplay | | Display lGetCurrentDisplay()(Code) | | Return in which Display instance the LF is visible.
the current display. |
| lGetDisplayable | | Displayable lGetDisplayable()(Code) | | Return the associated Displayable object.
the Displayable object. |
| lGetHeight | | int lGetHeight()(Code) | | Returns the height of the area available to the application.
height of the area available to the application |
| lGetWidth | | int lGetWidth()(Code) | | Returns the width of the area available to the application.
width of the area available to the application |
| lIsShown | | boolean lIsShown()(Code) | | Implement the public API isShown().
true if the DisplayableLF is interactive with user. |
| lRemoveCommand | | void lRemoveCommand(Command cmd, int i)(Code) | | Notifies look&feel object of a command removal
from the Displayable.
Parameters:
cmd - the command that was removed
Parameters:
i - the index of the removed command in Displayable.commands[] array |
| lSetDisplay | | void lSetDisplay(Display d)(Code) | | Set the display instance the Displayable is associated with.
Caller should hold LCDUILock around this call.
Parameters:
d - Display instance in which this DisplayableLF is visible.null if this DisplayableLF is no longer visible. |
| lSetTicker | | void lSetTicker(Ticker oldTicker, Ticker newTicker)(Code) | | Notifies Displayable's look & feel object of a ticker change.
Parameters:
oldTicker - the old ticker, or null for no ticker
Parameters:
newTicker - the new ticker, or null for no ticker |
| lSetTitle | | void lSetTitle(String oldTitle, String newTitle)(Code) | | Notifies Displayable's look & feel object of a title change.
Parameters:
oldTitle - the old title, or null for no title
Parameters:
newTitle - the new title, or null for no title |
| uCallFreeze | | void uCallFreeze()(Code) | | While UI resources of this LF are created and visible already, stop any
further updates to physical screen because some "system modal dialog"
takes over physical screen buffer and user input now.
Repaint and invalidate requests from this DisplayableLF will be really
scheduled into event queue. Instead, only dirty flag is set.
After a LF enters "freeze" mode, it can be resumed of visibility or
directly replaced by a new Displayable.
|
| uCallHide | | void uCallHide()(Code) | | Remove this displayable from physical screen.
The displayable should unload any resource that was allocated. It's not
required to clean the physical screen before this function returns.
This function could be called while a LF is in "freeze" mode.
|
| uCallInvalidate | | void uCallInvalidate()(Code) | | Relayout and repaint now. Called by the event handler to perform an
invalidation of this Displayable.
|
| uCallKeyEvent | | void uCallKeyEvent(int type, int keyCode)(Code) | | Handle key events.
Parameters:
type - defined in EventConstants.
Parameters:
keyCode - the key involved in this event. |
| uCallPaint | | void uCallPaint(Graphics g, Object target)(Code) | | Repaint now. Display calls this method on it's current Displayable.
Displayable uses this opportunity to do necessary stuff
on the Graphics context, this includes,
paint Ticker, paint Title, translate as necessary.
The target Object of this repaint may be some Object
initially set by this Displayable when the repaint was
requested - allowing this Displayable to know exactly
which Object it needs to call to service this repaint,
rather than potentially querying all of its Objects to
determine the one(s) which need painting.
SYNC NOTE: The caller of this method handles synchronization.
Parameters:
g - the graphics context to paint into.
Parameters:
target - the target Object of this repaint |
| uCallPointerEvent | | void uCallPointerEvent(int type, int x, int y)(Code) | | Handle pointer events.
Parameters:
type - kind of event, defined in EventConstants.
Parameters:
x - x-coordinate of pointer event
Parameters:
y - y-coordinate of pointer event |
| uCallScrollContent | | void uCallScrollContent(int scrollType, int thumbPosition)(Code) | | This method notify displayable to scroll its content
Parameters:
scrollType - scrollType
Parameters:
thumbPosition - |
| uCallShow | | void uCallShow()(Code) | | Prepare to show this LF on physical screen. This is the
internal version of showNotify() function as defined in MIDP spec.
It is called immediately prior to this LF being made visible
on the display. The LF should load any resource that is
needed, layout. App's paint() should NOT be called in this function.
Instead, it should be in the dsPaint() that will be called on this
LF shortly after.
|
| uCallSizeChanged | | void uCallSizeChanged(int w, int h)(Code) | | This method calls Displayable.sizeChanged method.
Parameters:
w - the new width
Parameters:
h - the new height |
| uIsScrollNative | | boolean uIsScrollNative()(Code) | | This method is used int repaint, int order to determine the
translation of the draw coordinates.
true if the scroll responsibility is of the native platform.false - if the scroll is done in the Java level. |
| uSetFullScreenMode | | void uSetFullScreenMode(boolean fullScreenMode)(Code) | | Notify the full screen mode of this LF.
If true, this DisplayableLF will take up as much screen
real estate as possible. Any subclass of Displayable
should be prepared to do their job to accommodate the
change.
Note that it can call into the app code.
Parameters:
fullScreenMode - true if full screen mode should be turned on |
| uSetRotatedStatus | | boolean uSetRotatedStatus(boolean newStatus)(Code) | | |
| updateCommandSet | | void updateCommandSet()(Code) | | Notifies look&feel object of commandset being updated.
|
|
|