com.sybase.uep.bobclient.controls
Interface ICustomEventsDelegate


public interface ICustomEventsDelegate

The custom events delegate.

Author:
bdeng

Method Summary
 void drawFocus(java.lang.Object field, int controlID, net.rim.device.api.ui.Graphics g, boolean on)
          Draws the focus indicator for this field.
 boolean navigationClick(java.lang.Object field, int controlID, ActionList actions, int status, int time)
          Invoked when the navigational action is selected.
 boolean navigationMovement(java.lang.Object field, int controlID, int dx, int dy, int status, int time)
          Invoked when a navigational motion occurs.
 boolean navigationUnclick(java.lang.Object field, int controlID, int status, int time)
          Invoked when the navigational action is released.
 void onFocus(java.lang.Object field, int controlID, int direction)
          Invoked when a field receives the focus.
 void onLoad(java.lang.Object field, int controlID)
          Invoked when the control loads data.
 void onOrientationChange(java.lang.Object field, int controlID, int width, int height)
          Invoked when the orientation changes.
 void onRecordChange(java.lang.Object field, int controlID)
          Invoked when the selected record changes.
 void onUnfocus(java.lang.Object field, int controlID)
          Invoked when a field loses the focus.
 void onValueChange(java.lang.Object field, int controlID, int context)
          Invoked when the control's value changes.
 void paint(java.lang.Object field, int controlID, net.rim.device.api.ui.Graphics g)
          Invoked by the framework to redraw a portion of this field.
 boolean touchEvent(java.lang.Object field, int controlID, net.rim.device.api.ui.TouchEvent message)
          Invoked when a touch event occurs.
 

Method Detail

onOrientationChange

void onOrientationChange(java.lang.Object field,
                         int controlID,
                         int width,
                         int height)
Invoked when the orientation changes.

Parameters:
field - the control
controlID - the control ID
width - amount of available horizontal space.
height - amount of available vertical space.

paint

void paint(java.lang.Object field,
           int controlID,
           net.rim.device.api.ui.Graphics g)
Invoked by the framework to redraw a portion of this field.

Parameters:
field - the control
controlID - the control ID
g - Graphics context for drawing the focus.

drawFocus

void drawFocus(java.lang.Object field,
               int controlID,
               net.rim.device.api.ui.Graphics g,
               boolean on)
Draws the focus indicator for this field.

Parameters:
field - the control
controlID - the control ID
g - Graphics context for drawing the focus.
on - true if the focus should be set; otherwise, false.

onLoad

void onLoad(java.lang.Object field,
            int controlID)
Invoked when the control loads data.

Parameters:
field - the control object
controlID - the control ID

onFocus

void onFocus(java.lang.Object field,
             int controlID,
             int direction)
Invoked when a field receives the focus.

Parameters:
field - the control
controlID - the control ID
direction - indicates from which direction the focus enters the field.

onUnfocus

void onUnfocus(java.lang.Object field,
               int controlID)
Invoked when a field loses the focus.

Parameters:
field - the control
controlID - the control ID

navigationClick

boolean navigationClick(java.lang.Object field,
                        int controlID,
                        ActionList actions,
                        int status,
                        int time)
Invoked when the navigational action is selected.

Parameters:
field - the control
controlID - the control ID
actions - the control's actions
status - Bitfield of values defined by KeypadListener.
time - number of milliseconds since the device was turned on.
Returns:

navigationUnclick

boolean navigationUnclick(java.lang.Object field,
                          int controlID,
                          int status,
                          int time)
Invoked when the navigational action is released.

Parameters:
field - the control
controlID - the control ID
status - Bitfield of values defined by KeypadListener.
time - number of milliseconds since the device was turned on.
Returns:

navigationMovement

boolean navigationMovement(java.lang.Object field,
                           int controlID,
                           int dx,
                           int dy,
                           int status,
                           int time)
Invoked when a navigational motion occurs.

Parameters:
field - the control
controlID - the control ID
dx - 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 - Bitfield of values defined by KeypadListener.
time - number of milliseconds since the device was turned on.
Returns:

touchEvent

boolean touchEvent(java.lang.Object field,
                   int controlID,
                   net.rim.device.api.ui.TouchEvent message)
Invoked when a touch event occurs.

Parameters:
field - the control
controlID - the control ID
message - TouchEvent object containing various input parameters including the event type and touch coordinates.

onValueChange

void onValueChange(java.lang.Object field,
                   int controlID,
                   int context)
Invoked when the control's value changes.

Parameters:
field - the control
controlID - the control ID
context - information specifying the origin of the change.

onRecordChange

void onRecordChange(java.lang.Object field,
                    int controlID)
Invoked when the selected record changes.

Parameters:
field - the control
controlID - the control ID