jcontrol.ui.wombat
Class NumberChooser

java.lang.Object
  jcontrol.ui.wombat.Component
      jcontrol.ui.wombat.AbstractFocusComponent
          jcontrol.ui.wombat.NumberChooser

All Implemented Interfaces:

java.util.EventListener, ActionProducer, KeyListener, TouchListener, IFocusable

public class NumberChooser
extends AbstractFocusComponent

The class NumberChosser implements a label showing a number. The number can be changed via the up-down buttons on the keyboard or by using the touch screen.
When the user changes the state, an ActionEvent of type ActionEvent.VALUE_CHANGED is fired.

(c) Copyright 2005 DOMOLOGIC GmbH

Author:

Marcus Timmermann

Field Summary

Fields inherited from class jcontrol.ui.wombat.Component

backgroundColor, COLOR_COMPONENT_BACKGROUND, COLOR_COMPONENT_BACKGROUND_HIGHLIGHTED, COLOR_COMPONENT_DARK_SHADOW, COLOR_COMPONENT_FOREGROUND, COLOR_COMPONENT_FOREGROUND_INACTIVE, COLOR_COMPONENT_HIGHLIGHT_SHADOW, COLOR_COMPONENT_LIGHT_SHADOW, COLOR_COMPONENT_LIST_BACKGROUND, COLOR_COMPONENT_NORMAL_SHADOW, COLOR_COMPONENT_SELECTION_TEXT, COLOR_COMPONENT_SELECTION_TEXT_BACKGROUND, COLOR_COMPONENT_SELECTION_TEXT_BACKGROUND_INACTIVE, COLOR_COMPONENT_SELECTION_TEXT_INACTIVE, foregroundColor, frame, height, parent, state, transparentColor, width, x, y

Fields inherited from interface jcontrol.ui.wombat.IFocusable

TRANSFER_FOCUS_BACKWARD, TRANSFER_FOCUS_FORWARD

Fields inherited from interface jcontrol.ui.wombat.event.TouchListener

RESULT_ACCEPTED, RESULT_EXECUTED, RESULT_NONE

Constructor Summary

NumberChooser(int x, int y, int min, int max)
Creates a new number chooser.

Method Summary

int	getValue() Returns the current value.
KeyEvent	onKeyEvent(KeyEvent e) Handle key events.
int	onTouchEvent(TouchEvent e) Handle TouchEvent.
void	paint(jcontrol.graphics.XGraphics g) Paint this number chooser.
boolean	setValue(int value) Sets the specified value.

Methods inherited from class jcontrol.ui.wombat.AbstractFocusComponent

getActionListener, requestFocus, setActionListener, setEnabled, setVisible

Methods inherited from class jcontrol.ui.wombat.Component

getFrame, isEnabled, isVisible, repaint, repaintAll, safeExec, setBackgroundColor, setBounds, setDirty, setFont, setForegroundColor, setRedraw, setTransparentColor, unsafeExec, update

Methods inherited from class java.lang.Object

equals, getClass, notifyAll, toString, wait

Constructor Detail

NumberChooser

public NumberChooser(int x,
                     int y,
                     int min,
                     int max)

Creates a new number chooser.

Parameters:

x - the x position

y - the y position

min - the minimum value the number chooser should be able to show

max - the maximum value the number chooser should be able to show

Method Detail

getValue

public int getValue()

Returns the current value.

onKeyEvent

public KeyEvent onKeyEvent(KeyEvent e)

Handle key events. On several user actions, an ActionEvent is fired.

Specified by:

onKeyEvent in interface KeyListener

Specified by:

onKeyEvent in class AbstractFocusComponent

Parameters:

e - the event that contains information about the key.

Returns:

null if the KeyEvent has been consumed by the KeyListener,
or the the specified KeyEvent if it should be passed on to the next KeyListener.

onTouchEvent

public int onTouchEvent(TouchEvent e)

Handle TouchEvent.

Specified by:

onTouchEvent in interface TouchListener

Specified by:

onTouchEvent in class AbstractFocusComponent

Parameters:

e - The touch event.

Returns:

RESULT_ACCEPTED if the TouchEvent has been consumed by the TouchListener,
RESULT_EXECUTED if the TouchEvent has been consumed by the TouchListener and some important action has been performed, e.g. an action event has been invoked,
RESULT_NONE if the TouchEvent should be passed on to the next TouchListener.

paint

public void paint(jcontrol.graphics.XGraphics g)

Paint this number chooser. Don't call this method directly.

Overrides:

paint in class Component

Parameters:

g - the application's graphics object.

setValue

public boolean setValue(int value)

Sets the specified value.

Parameters:

value - the value to set

Returns:

true if the value has changed