net.rim.device.api.ui.component.pane
Class HorizontalTabController

java.lang.Object
  net.rim.device.api.ui.component.pane.PaneManagerController
      net.rim.device.api.ui.component.pane.HorizontalTabController

public class HorizontalTabController
extends PaneManagerController

Extension of PaneManagerController that implements a controller for the HorizontalTabTitleView.

Navigation movement within the HorizontalTabTitleView only scrolls the titles.

Navigation click within the HorizontalTabTitleView causes the pane to change to the selected one if it is not already selected.

TouchGesture.TAP within the HorizontalTabTitleView causes the pane to change to the selected one if it is not already selected.

Since:

BlackBerry API 6.0.0

Constructor Summary

HorizontalTabController()
Basic class constructor.

Method Summary
boolean	navigationClick(int status, int time) Invoked in response to a navigational action.
boolean	touchEvent(TouchEvent message) Handles touch input events (see TouchEvent).

Methods inherited from class net.rim.device.api.ui.component.pane.PaneManagerController

getCommand, getModel, getView, isInBounds, keyChar, keyControl, keyDown, keyRepeat, keyStatus, keyUp, navigationMovement, setCommand, setModel, setView

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HorizontalTabController

public HorizontalTabController()

Basic class constructor.

Since:

BlackBerry API 6.0.0

Method Detail

navigationClick

public boolean navigationClick(int status,
                               int time)

Invoked in response to a navigational action.

The system invokes this method when passing on a navigational click event.

The source of the navigation event can be determined by checking the KeypadListener#STATUS_TRACKWHEEL and KeypadListener#STATUS_FOUR_WAY bits in the status parameter; exactly one of them will be set.

Overrides:

navigationClick in class PaneManagerController

Parameters:

status - Bitfield of values defined by KeypadListener.

time - Number of milliseconds since the device was turned on.

Returns:

True if this method consumed the event; otherwise, false.

Since:

BlackBerry API 6.0.0

touchEvent

public boolean touchEvent(TouchEvent message)

Handles touch input events (see TouchEvent).

The coordinates reflect the location of the touch event with respect to the top-left of the associated view. The x, y coordinates are then further mapped to the top-left corner of the field with input.

Overrides:

touchEvent in class PaneManagerController

Parameters:

message - TouchEvent object containing various input parameters including the event type and touch coordinates.

Returns:

True if event consumed; otherwise, false.

Throws:

IllegalArgumentException - If message is null.

Since:

BlackBerry API 6.0.0