net.rim.device.api.system
Interface TrackwheelListener

All Superinterfaces:
KeypadListener

Deprecated. Use Screen.navigationClick(int, int) or Screen.navigationMovement(int, int, int, int) instead.

public interface TrackwheelListener
extends KeypadListener

NOTE: Use of this interface is strongly discouraged.

A listener interface for receiving trackwheel events.

Instead of using this interface, developers are strongly encouraged to use the "navigation" methods in the Screen class to receive such notifications. This is done by extending the Screen class and providing custom implementations of the following 3 methods:

See the BlackBerry Java Development Environment Development Guide and the API Reference for more information.


Field Summary
 
Fields inherited from interface net.rim.device.api.system.KeypadListener
STATUS_ALT, STATUS_ALT_LOCK, STATUS_CAPS_LOCK, STATUS_FOUR_WAY, STATUS_KEY_HELD_WHILE_ROLLING, STATUS_NOT_FROM_KEYPAD, STATUS_SHIFT, STATUS_SHIFT_LEFT, STATUS_SHIFT_RIGHT, STATUS_TRACKWHEEL
 
Method Summary
 boolean trackwheelClick(int status, int time)
          Deprecated. 
 boolean trackwheelRoll(int amount, int status, int time)
          Deprecated. 
 boolean trackwheelUnclick(int status, int time)
          Deprecated. 
 

Method Detail

trackwheelClick

public boolean trackwheelClick(int status,
                               int time)
Deprecated. 
Invoked when the trackwheel is clicked.

Parameters:
status - Modifier key status.
time - Ticks since device reset.
Returns:
True if the event was consumed; otherwise, false.

trackwheelRoll

public boolean trackwheelRoll(int amount,
                              int status,
                              int time)
Deprecated. 
Invoked when the trackwheel is rolled.

The parameter amount is negative for a upwards roll, and positive for a downwards roll.

Parameters:
status - Modifier key status.
time - Ticks since device reset.
amount - Amount by which the trackwheel has rotated since the last event; negative values indicate an upwards (or backwards) roll, and positive values indicate a downwards (or fowards) roll.
Returns:
True if the event was consumed; otherwise, false.

trackwheelUnclick

public boolean trackwheelUnclick(int status,
                                 int time)
Deprecated. 
Invoked when the trackwheel is released
Parameters:
status - Modifier key status.
time - Ticks since device reset.
Returns:
True if the event was consumed; otherwise, false.



Copyright 1999-2008 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.