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:

• Screen.navigationClick(int, int)
• Screen.navigationUnclick(int, int)
• Screen.navigationMovement(int, int, int, int)

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. Invoked when the trackwheel is clicked.
boolean	trackwheelRoll(int amount, int status, int time) Deprecated. Invoked when the trackwheel is rolled.
boolean	trackwheelUnclick(int status, int time) Deprecated. Invoked when the trackwheel is released

Method Detail

trackwheelClick

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.

trackwheelUnclick

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.

trackwheelRoll

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.