|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object
|
+--net.rim.device.api.ui.Field
|
+--net.rim.device.api.ui.Manager
|
+--net.rim.device.api.ui.Screen
Base class for all screens.
Each UiEngine presents an interface to the user by pushing
screens onto its display stack, and popping them off when interaction with
the managed fields on that screen is finished.
Delegate manager
Each screen object has a delegate manager, the single Manager object
directly controlled by the screen to handle layout and scrolling for the
entire screen.
*
styles
Screen does not accept Field.FOCUSABLE_MASK,
Field.EDITABLE_MASK.
| Field Summary | ||
static long |
DEFAULT_CLOSE
If specified, screen will provide a close action. |
|
static long |
DEFAULT_MENU
If specified, screen will provide a default menu. |
|
| Fields inherited from class net.rim.device.api.ui.Manager |
BOTTOMMOST, DOWNWARD, HORIZONTAL_SCROLL, HORIZONTAL_SCROLL_MASK, HORIZONTAL_SCROLLBAR, HORIZONTAL_SCROLLBAR_MASK, LEAVE_BLANK_SPACE, LEFTMOST, LEFTWARD, NO_HORIZONTAL_SCROLL, NO_HORIZONTAL_SCROLLBAR, NO_SCROLL_RESET, NO_VERTICAL_SCROLL, NO_VERTICAL_SCROLLBAR, QUANTA_FONT, RIGHTMOST, RIGHTWARD, TOPMOST, UPWARD, VERTICAL_SCROLL, VERTICAL_SCROLL_MASK, VERTICAL_SCROLLBAR, VERTICAL_SCROLLBAR_MASK |
| Fields inherited from class net.rim.device.api.ui.Field |
ACTION_INVOKE, EDITABLE, EDITABLE_MASK, FIELD_BOTTOM, FIELD_HALIGN_MASK, FIELD_HCENTER, FIELD_LEFT, FIELD_RIGHT, FIELD_TOP, FIELD_VALIGN_MASK, FIELD_VCENTER, FOCUSABLE, FOCUSABLE_MASK, HIGHLIGHT_FOCUS, HIGHLIGHT_SELECT, NON_FOCUSABLE, READONLY, STATUS_MOVE_FOCUS_HORIZONTALLY, STATUS_MOVE_FOCUS_VERTICALLY, USE_ALL_HEIGHT, USE_ALL_WIDTH |
| Constructor Summary | ||
Screen(Manager delegate)
Constructs a screen with provided delegate manager. |
||
Screen(Manager delegate,
long style)
Constructs specific type of screen with provided delegate manager. |
||
| Method Summary | ||
void |
add(Field field)
Adds a field to this screen's manager. |
|
void |
addKeyListener(KeyListener listener)
Registers a key event listener for this screen. |
|
void |
addTrackwheelListener(TrackwheelListener listener)
Registers a trackwheel event listener for this screen. |
|
|
void |
close()
Closes this screen. |
void |
delete(Field field)
Deletes a field from this screen's manager. |
|
void |
deleteRange(int start,
int count)
Deletes a range of fields from this screen's manager. |
|
|
void |
doPaint()
Paints this screen. |
|
void |
ensureRegionVisible(Field field,
int x,
int y,
int width,
int height)
Attempts to make your provided region visible. |
Application |
getApplication()
Retrieves this screen's application. |
|
|
MenuItem |
getDefaultMenuItem(int instance)
Retrieves the default menu item. |
Manager |
getDelegate()
Retrieves this screen's delegate manager. |
|
Field |
getField(int index)
Retrieves controlled field with specified index. |
|
int |
getFieldAtLocation(int x,
int y)
Retrieves index of field under provided point. |
|
int |
getFieldCount()
Retrieves the number of controlled fields. |
|
Field |
getFieldWithFocus()
Retrieves controlled field with focus. |
|
int |
getFieldWithFocusIndex()
Retrieves index of controlled field with focus. |
|
void |
getFocusRect(XYRect rect)
Retrieves current extent of the focus. |
|
Graphics |
getGraphics()
Retrieves the graphics context for this screen. |
|
Field |
getLeafFieldWithFocus()
Retrieves leaf field with focus. |
|
Menu |
getMenu(int instance)
Retrieves the menu. |
|
Screen |
getScreenAbove()
Retrieves handle for screen above this one. |
|
Screen |
getScreenBelow()
Retrieves handle for screen below this one. |
|
UiEngine |
getUiEngine()
Retrieves UiEngine that owns the display. |
|
void |
insert(Field field,
int index)
Inserts a field to this screen's manager. |
|
void |
invalidate()
Invalidates a region of this screen. |
|
void |
invalidate(int x,
int y,
int width,
int height)
Invalidates a region of this screen. |
|
void |
invalidateAll(int x,
int y,
int width,
int height)
Invalidates a region of this screen. |
|
void |
invalidateLayout()
Invalidates this screen's layout (including all controlled fields). |
|
|
protected boolean |
invokeAction(int action)
Invokes an action on this screen. |
boolean |
isDataValid()
Computes and returns whether or not the data on this screen is valid. |
|
boolean |
isDirty()
Determines if this screen is dirty. |
|
boolean |
isDisplayed()
Determines if this screen is currently in use. |
|
boolean |
isFocusable()
Verifies that the delegate manager accepts the focus. |
|
boolean |
isGlobal()
Determines if this is a global screen. |
|
boolean |
isGlobalStatus()
Deprecated. Use isGlobal() |
|
boolean |
isMuddy()
Determines if this screen is muddy. |
|
boolean |
isSelecting()
Determines if this screen has the focus. |
|
protected boolean |
keyChar(char c,
int status,
int time)
Delegates key generation event to the controlled field with focus. |
|
protected boolean |
keyCharUnhandled(char key,
int status,
int time)
Invoked when a keyChar event is unhandled. |
|
protected boolean |
keyControl(char c,
int status,
int time)
Delegates key generation event to the controlled field with focus. |
|
protected boolean |
keyDown(int keycode,
int time)
Delegates key down event to controlled field with focus. |
|
protected boolean |
keyRepeat(int keycode,
int time)
Delegates key repeat event to controlled field with focus. |
|
protected boolean |
keyStatus(int keycode,
int time)
Delegates key status event to controlled field with focus. |
|
protected boolean |
keyUp(int keycode,
int time)
Delegates key up event to controlled field with focus. |
|
protected void |
layoutDelegate(int width,
int height)
Lays out this screen's delegate. |
|
protected void |
makeMenu(Menu menu,
int instance)
Called from onMenu to populate the menu. |
|
|
protected boolean |
navigationClick(int status,
int time)
Delegates navigational click events. |
|
protected boolean |
navigationMovement(int dx,
int dy,
int status,
int time)
Invoked when a navigational motion occurs. |
|
protected boolean |
navigationUnclick(int status,
int time)
Delegates navigation unclick events. |
|
boolean |
onClose()
Indicates a close event has occurred. |
|
protected void |
onDisplay()
Invoked when this screen is pushed onto the display stack. |
|
protected void |
onExposed()
Invoked when this screen is exposed. |
|
protected void |
onFocus(int direction)
Finds a controlled field to give the focus. |
|
protected void |
onFocusNotify(boolean focus)
Called whenever the screen has gained or lost focus. |
|
boolean |
onMenu(int instance)
Invoked when a menu needs displaying. |
protected void |
onMenuDismissed()
Deprecated. Use onMenuDismissed(Menu). |
|
protected void |
onMenuDismissed(Menu menu)
Called when the menu is dismissed. |
|
|
protected void |
onObscured()
Invoked when this screen is obscured. |
|
protected boolean |
onSave()
Invoked when the screen should save its contents. |
|
protected boolean |
onSavePrompt()
Invoked when the screen should prompt to save its contents. |
|
protected void |
onUndisplay()
Invoked when this screen is popped off the display stack. |
|
protected void |
onUnfocus()
Invoked when focus is removed from this screen. |
protected boolean |
openDevelopmentBackdoor(int backdoorCode)
Handles development backdoor key-sequences. |
|
protected boolean |
openProductionBackdoor(int backdoorCode)
Handles production backdoor key-sequences. |
|
protected void |
paint(Graphics graphics)
Paints this screen's visible region. |
|
|
protected void |
paintBackground(Graphics graphics)
Paint this screen's background. |
|
void |
removeFocus()
Removes focus from this screen. |
void |
removeKeyListener(KeyListener listener)
Removes a key event listener from this screen. |
|
void |
removeTrackwheelListener(TrackwheelListener listener)
Removes a trackwheel event listener from this screen. |
|
void |
replace(Field oldField,
Field newField)
Removes a field from this Screen and replaces it with another field. |
|
void |
save()
Invoked when the screen should save its contents. |
|
boolean |
scroll(int direction)
Scrolls the focus in specified direction. |
|
protected void |
setBackdoorAltStatus(boolean altStatus)
Sets whether backdoors key sequences use ALT'd or un-ALT'd keystrokes. |
|
protected void |
setDefaultClose(boolean provideDefaultClose)
This method controls whether the screen's menu contains a "close" menu item. |
|
void |
setDirty(boolean dirty)
Cleans or dirties all controlled fields. |
|
void |
setFocus()
Sets the focus to the delegate manager. |
|
boolean |
setFocus(Field field,
int x,
int y,
int status,
int time)
Sets focus to exact position in current screen. |
|
void |
setHorizontalQuantization(int horizontalQuanta)
Sets the horizontal quantization. |
|
protected void |
setPositionDelegate(int x,
int y)
Set the position of this screen's layout manager (delegate). |
|
void |
setTrackballFilter(int filter)
Sets the trackball filter for this Screen. |
|
void |
setTrackballSensitivityXOffset(int trackballSensitivityXOffset)
Sets the relative trackball sensitivity for the X axis. |
|
void |
setTrackballSensitivityYOffset(int trackballSensitivityYOffset)
Sets the relative trackball sensitivity for the X axis. |
|
void |
setVerticalQuantization(int verticalQuanta)
Sets the vertical quantization. |
|
protected boolean |
trackwheelClick(int status,
int time)
Delegates trackwheel click events. |
|
protected boolean |
trackwheelClickUnhandled(int status,
int time)
Handles trackwheel click event if delegate passes it through. |
|
protected boolean |
trackwheelRoll(int amount,
int status,
int time)
Invoked when the trackwheel is rolled. |
|
protected boolean |
trackwheelUnclick(int status,
int time)
Delegates trackwheel unclick events. |
|
void |
updateDisplay()
Updates the display. |
|
| Methods inherited from class net.rim.device.api.ui.Manager |
deleteAll, getHorizontalScroll, getPreferredHeightOfChild, getPreferredWidthOfChild, getVerticalScroll, getVirtualHeight, getVirtualWidth, getVisibleHeight, getVisibleWidth, invalidateFieldRange, isDownArrowShown, isUpArrowShown, isValidLayout, layout, layoutChild, moveFocus, moveFocus, nextFocus, paintChild, setFocus, setHorizontalScroll, setPositionChild, setScrollListener, setVerticalScroll, setVirtualExtent, sublayout, subpaint |
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
public static final long DEFAULT_CLOSE
When ESC is pressed, the close() method will be called, and a
menu item is also provided to do this.
public static final long DEFAULT_MENU
| Constructor Detail |
public Screen(Manager delegate)
delegate - Manager this screen uses as layout delegate.public Screen(Manager delegate, long style)
Use this constructor to build a screen of a particular style.
delegate - Manager this screen uses as layout delegate.style - Style the screen uses for instantiation| Method Detail |
public void add(Field field)
Provided a field, this method invokes Manager.add(net.rim.device.api.ui.Field) on this
screen's delegate manager, prompting the manager to add the field.
field - Field to add.public final void addKeyListener(KeyListener listener)
listener - Key event listener to handle key events passed to this
screen.public final void addTrackwheelListener(TrackwheelListener listener)
listener - Trackwheel event listener to handle trackwheel events
pass to this screen.public void close()
By default, this method pops this screen, and if the
screen stack is empty, invokes
System.exit(0). Derived classes can override this
method to provide more particular functionality.
public void delete(Field field)
This method invokes Manager.delete(net.rim.device.api.ui.Field) on this screen's delegate
manager to delete your provided field. Note that, after deletion, the
list of fields gets compacted.
field - Field to delete.
public void deleteRange(int start,
int count)
This method invokes Manager.deleteRange(int, int) on this screen's
delegate maanger to delete a range of fields. Note that, after deletion,
the list of fields gets compacted.
deleteRange in class Managerstart - Index of first field to delete.count - Number of fields to delete.public final void doPaint()
Invoke this method to force a repaint of this screen, its delegate manager, and all owned fields.
public void ensureRegionVisible(Field field, int x, int y, int width, int height)
Pass this method a field, and a region (extent), and this method attempts to scroll the screen to make as much of your region visible as possible.
If your region is smaller than the screen's visible extent, this method does as little work as possible to ensure the entire region appears on the screen.
If your region is larger than the screen's visible extent, this method produces the net effect of aligning the top left corner of your region with the top left corner of the screen's visible extent.
field - Field that contains your region.x - Left edge of the region.y - Top edge of the region.width - Width (in pixels) of the region.height - Height (in pixels) of the region.public Application getApplication()
public MenuItem getDefaultMenuItem(int instance)
instance - The instance of the desired menu. If your screen supports
only one menu, this may be ignored. By default, it is 0.public Manager getDelegate()
public Field getField(int index)
This method invokes Manager.getField(int) on this screen's
delegate manager to retrieve a particular field from its list.
index - Index of field to retrieve.IndexOutOfBoundsException - If index not valid.
public int getFieldAtLocation(int x,
int y)
This method invokes Manager.getFieldAtLocation(int, int) on this
screen's delegate manager.
getFieldAtLocation in class Managerx - Distance from left edge of screen's extent.y - Distance from top edge of screen's extent.public int getFieldCount()
This method invokes Manager.getFieldCount() on this screen's
delegate manager to retrieve the number of fields it controls.
getFieldCount in class Managerpublic Field getFieldWithFocus()
This method invokes Manager.getFieldWithFocus() on this
screen's delegate manager to retrieve the currently focussed field.
getFieldWithFocus in class Managerpublic int getFieldWithFocusIndex()
This method invokes Manager.getFieldWithFocusIndex() on this
screen's delegate manager to retrieve the currently focussed field.
getFieldWithFocusIndex in class Managerpublic void getFocusRect(XYRect rect)
Invoke this method to retrieve the extent of the current focus region. Notice that the coordinates expressed are local to this screen's region.
getFocusRect in class Managerrect - Object to receive retrieved extent data.public Graphics getGraphics()
This method returns the graphics context for this screen, with a clipping region on top of the graphics stack set to the screen's entire extent.
The Graphics object returned by this call becomes invalid and should not be used after the end of the current UI event.
Note: We recommend against direct use of this method;
instead, use the various invalidate() methods. It may be used for
direct drawing to the display when the screen contains no fields.
public Field getLeafFieldWithFocus()
This method invokes Manager.getLeafFieldWithFocus() on this
screen's delegate manager to retrieve the (bottom-most, non-manager) leaf
field that has the focus.
getLeafFieldWithFocus in class Managerpublic Menu getMenu(int instance)
instance - Instance of the desired menu; if this screen supports
only one menu, this may be ignored. By default, it is 0.onMenu(int),
#makeMenuWithContextpublic Screen getScreenAbove()
public Screen getScreenBelow()
public final UiEngine getUiEngine()
public void insert(Field field, int index)
Provided a field and an index, this method invokes
Manager.insert(Field,int) on this screen's delegate manager,
prompting the manager to insert the field at the specified position in
its list.
field - Field to insert.index - Position in manager's list of controlled fields at which to
insert new field.public void invalidate()
This method marks a region of this screen as needing a repaint. The repainting is handled later by the main event dispatch thread.
Note: Any thread can safely invoke this method,
and does not require to synchronize on the
event lock.
invalidate in class ManagerField.invalidate()
public void invalidate(int x,
int y,
int width,
int height)
This method marks a region of this screen as needing a repaint. The repainting is handled later by the main event dispatch thread.
Note: Any thread can safely invoke this method,
and does not require to synchronize on the
event lock.
invalidate in class Managerx - Left edge of the region in ContentRect coordinates.y - Top edge of the region in ContentRect coordinates.width - Width (in pixels) of the region.height - Height (in pixels) of the region.Field.invalidate(int,int,int,int)
public void invalidateAll(int x,
int y,
int width,
int height)
This method marks a region of this screen as needing a repaint. The repainting is handled later by the main event dispatch thread.
Note: Any thread can safely invoke this method,
and does not require to synchronize on the
event lock.
invalidateAll in class Fieldx - Left edge of the region in field coordinates.y - Top edge of the region in field coordinates.width - Width (in pixels) of the region.height - Height (in pixels) of the region.Field.invalidate(int,int,int,int)public void invalidateLayout()
This method prompts this screen's delegate manager to invalidate this screen's layout.
IllegalStateException - If this method is called while the screen
is displayed.protected boolean invokeAction(int action)
invokeAction(action) is invoked on the
object returned from getDelegate(). If Manager.invokeAction(int) returns
true then true is returned. Otherwise, the following logic is performed:
action is not Field.ACTION_INVOKE then false is returned.getLeafFieldWithFocus() returns null then false is returned.true is returned.invokeAction in class Manageraction - the action to be performed as described above.true if the action was consumed; false if the action
was not consumed.public boolean isDataValid()
The current implementation simply returns this.getDelegate().isDataValid().
isDataValid in class Managertrue if the data of all fields on this screen are valid or
false if the data of at least one field on this screen is not valid.Manager.isDataValid(),
getDelegate()public boolean isDirty()
This method invokes Manager.isDirty() on this screen's delegate
manager.
setDirty(boolean) was invoked (which is also passed on to the delegate
manager); otherwise, false.public final boolean isDisplayed()
This will return true iff this screen is on a display stack. Its position within the stack does not matter; this function does not indicate visibility. A screen is deemed displayed as soon as it is pushed onto the display stack, and not displayed as soon as it is popped from the display stack.
For Global Screens, this indicates whether this screen is the current one displayed. Any Global Screen that has been queued or that has had its display preempted by a higher priority Global Screen is deemed not displayed.
public boolean isFocusable()
This method invokes Manager.isFocusable() on this screen's
delegate manager to determine whether the delegate manager (and thus the
screen) accepts the focus.
isFocusable in class Managerpublic boolean isGlobal()
public boolean isMuddy()
This method invokes Manager.isMuddy() on this screen's delegate
manager.
public boolean isSelecting()
This method invokes Manager.isSelecting() on this screen's
delegate manager.
isSelecting in class Manager
protected boolean keyChar(char c,
int status,
int time)
This method invokes Manager.keyChar(char, int, int) on this screen's delegate
manager.
c - Character generated.status - Modifier key status.time - Number of milliseconds since the device was turned on.
protected boolean keyCharUnhandled(char key,
int status,
int time)
Derived classes should override this event to provide custom handling of keyChar events that remain unhandled by any of their controlled fields.
key - Character generated.status - Modifier key status.time - Number of milliseconds since the device was turned on.ESCAPE
key, then this method returns true if this screen closes; otherwise,
this method returns false.
protected boolean keyControl(char c,
int status,
int time)
This method invokes Manager.keyControl(char, int, int) on this screen's
delegate manager.
keyControl in class Managerc - Character generated.status - Modifier key status.time - Number of milliseconds since the device was turned on.
protected boolean keyDown(int keycode,
int time)
This method invokes Manager.keyDown(int, int) on this screen's delegate
manager.
keycode - Key scan code of the key pressed, ignoring any effects of
modifier keys.time - Number of milliseconds since the device was turned on.
protected boolean keyRepeat(int keycode,
int time)
This method invokes Manager.keyRepeat(int, int) on this screen's
delegate manager.
keycode - Key scan code of key to repeat, ignoring any effects of
modifier keys.time - Number of milliseconds since the device was turned on.
protected boolean keyStatus(int keycode,
int time)
This method invokes Manager.keyStatus(int, int) on this screen's
delegate manager.
keycode - Key scan code of character shown, before any effects of
modifier keys.time - Number of milliseconds since the device was turned on.
protected boolean keyUp(int keycode,
int time)
This method invokes Manager.keyUp(int, int) on this screen's delegate
manager.
keycode - Key scan code of the key released, ignoring any effects of
modifier keys.time - Number of milliseconds since the device was turned on.
protected final void layoutDelegate(int width,
int height)
width - Amount of available horizontal space.height - Amount of available vertical space.protected void makeMenu(Menu menu, int instance)
menu - Menu to which items should be added.instance - The instance of the desired menu. If your screen supports
only one menu, this may be ignored. By default, it is 0.onMenu(int)
protected boolean navigationClick(int status,
int time)
This method passes on navigation click events to this
screen's delegate manager by invoking Manager.navigationClick(int, int).
navigationClick in class Managerstatus - State of the modifier keys.time - Number of milliseconds since the device was turned on. One scenario that calls this method is
when a Screen object is pushed to an application and a Navigation event is injected
into the same application. When this scenario occurs, this method is called using 0 for the time parameter.
protected boolean navigationMovement(int dx,
int dy,
int status,
int time)
KeypadListener.STATUS_TRACKWHEEL
and KeypadListener.STATUS_FOUR_WAY bits in the status parameter;
exactly one of these will be set.navigationMovement in class Managerdx - Magnitude of navigational motion: negative for a move left
and postive for a move right.dy - Magnitude of navigational motion: negative for an upwards
move, and positive for a downwards move.status - Modifier key status at time of move.time - Number of milliseconds since the device was turned on. One scenario that calls this method is
when a Screen object is pushed to an application and a Navigation event is injected
into the same application. When this scenario occurs, this method is called using 0 for the time parameter.
protected boolean navigationUnclick(int status,
int time)
This method passes on navigation unclick events to
this screen's delegate manager by invoking
Manager.navigationUnclick(int, int).
navigationUnclick in class Managerstatus - State of the modifier keys.time - Number of milliseconds since the device was turned on. One scenario that calls this method is
when a Screen object is pushed to an application and a Navigation event is injected
into the same application. When this scenario occurs, this method is called using 0 for the time parameter.public boolean onClose()
The default implementation is activated by specifying
DEFAULT_CLOSE. It will call onSavePrompt() if the screen
is dirty, then call close() if successful.
protected void onDisplay()
This method is invoked by the system after this screen is pushed onto the stack and layout has been done, but before any painting occurs.
If no controlled field has the focus, this method attempts to assign the focus to the first field that will accept it, starting with the first field in the delegate manager's field list. Additionally, this method makes the focus visible, and resets scrolling to 0 if possible (ensuring the focussed region stays on the screen).
The complementary callback is onUndisplay().
onExposed(),
Field.onVisibilityChange(boolean)protected void onExposed()
Subclasses of screen should override this method for special handling.
The complimenting callback is onObscured().
onDisplay(),
Field.onVisibilityChange(boolean)protected void onFocus(int direction)
This method invokes Manager.onFocus(int) on this screen's delegate
manager, thus starting with the delegate manager's controlled field list,
looking for a field to give the focus. This method passes the focus to
the first found field that accepts it.
direction - If 1, start at the top of the delegate manager's field
list and search foward. If -1, start at the bottom of the delegate
manager's field list and search backward.protected void onFocusNotify(boolean focus)
focus - true if this screen has gained the focus or false if this screen has lost focus.public boolean onMenu(int instance)
If you specify the DEFAULT_MENU style, this method creates a
menu and call #makeMenuWithContext(Menu,int).
Then menu.show() will be invoked, and
MenuItem.run() used to activate the selected item.
Note: Please use this instead of overriding
trackwheelClick(int, int); this may be called in other events, such as a
menu button.
instance - Instance of the menu to display. If your screen supports
only one menu, this may be ignored. By default, it is 0.protected void onMenuDismissed()
onMenuDismissed in class Fieldprotected void onMenuDismissed(Menu menu)
onMenuDismissed(Menu) on all the fields and managers
that are currently in focus. It also calls onMenuDismissed().onMenuDismissed in class Fieldmenu - Menu to be dismissedprotected void onObscured()
Derived classes should override this method for special handling.
The complimenting callback is onExposed().
onObscured in class FieldonUndisplay(),
Field.onVisibilityChange(boolean)protected boolean onSave()
If isDataValid() returns true, this method then calls
save() (and displays an error dialog if save() throws an
IOException).
protected boolean onSavePrompt()
The default implementation is empty. Overriding classes should provide a dialog and call onSave if the user has chosen to save. If the return is true, the framework will call onClose.
MainScreen.onSavePrompt()protected void onUndisplay()
Derived classes should override this method for special handling.
The complimenting callback is onDisplay().
onUndisplay in class ManageronObscured(),
Field.onVisibilityChange(boolean)protected void onUnfocus()
This method invokes Manager.onUnfocus() on this screen's
delegate manager to remove the focus from this screen.