org.formaria.awt
Class Keypad

java.lang.Object
  java.awt.Component
      org.formaria.awt.Keypad

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, TextHolder, StateListener

public class Keypad
extends java.awt.Component
implements StateListener, TextHolder

An KeyPad component is a visual representation of a numeric keypad.

Copyright (c) Formaria Ltd., 2008, This software is licensed under the GNU Public License (GPL), please see license.txt for more details. If you make commercial use of this software you must purchase a commercial license from Formaria.

$Revision: 1.6 $

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

protected int	borderHeight
protected int	borderWidth
protected ClickListener	clickListener
protected int	keyHeight
protected int	keyWidth
protected StyleManager	styleManager

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Keypad()
Constructor for a new Keypad.

Method Summary

void	clear() Clears the output value.
int	findCurrentResponse(int x, int y) Find the response corresponding to the current point
java.awt.Color	getColor(int idx, int callerClassId) Gets an indexed color.
java.lang.String	getStyle3D() Get the style asociated with three dimensional objects/elements
java.lang.String	getStyleShade() Get the style asociated with shaded elements
java.lang.String	getText() Gets the output value
java.lang.String	getValue() Gets the output value
void	paint(java.awt.Graphics sg) Renders the keypad
void	paintStates() Repaint the responses
boolean	respond() Called by ClickListener to check if a response event should be sent to the parent form.
void	setMaxLength(int len) Sets the maximum length of the output value
void	setMinLength(int len) Sets the minimum length of the output value
void	setOutputField(TextHolder of) Sets a text field in which to display the key value.
boolean	setState(int x, int y, int defResponse) Find a response
void	setStyle(java.lang.String newStyle) Set the style asociated with shaded elements, background and text colors
void	setStyle3D(java.lang.String newStyle) Get the style asociated with three dimensional objects/elements
void	setStyleShade(java.lang.String newStyle) Set the style asociated with shaded elements, frame color
void	setText(java.lang.String newText) Sets the control's text.
void	setValue(java.lang.String newValue) Sets the output value
void	update(java.awt.Graphics g) Refresh the display
void	updateSelectedState() Does nothing in this instance

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

borderHeight

protected int borderHeight

borderWidth

protected int borderWidth

keyHeight

protected int keyHeight

keyWidth

protected int keyWidth

clickListener

protected ClickListener clickListener

styleManager

protected StyleManager styleManager

Constructor Detail

Keypad

public Keypad()

Constructor for a new Keypad. This control displays a numeric keypad

Method Detail

update

public void update(java.awt.Graphics g)

Refresh the display

Overrides:

update in class java.awt.Component

Parameters:

g -

paint

public void paint(java.awt.Graphics sg)

Renders the keypad

Overrides:

paint in class java.awt.Component

Parameters:

sg -

paintStates

public void paintStates()

Repaint the responses

Specified by:

paintStates in interface StateListener

setState

public boolean setState(int x,
                        int y,
                        int defResponse)

Find a response

Specified by:

setState in interface StateListener

Parameters:

x - the x coordinate of the mouse click

y - the y coordinate of the mouse click

defResponse - the default response

Returns:

true if a response was found

findCurrentResponse

public int findCurrentResponse(int x,
                               int y)

Find the response corresponding to the current point

Specified by:

findCurrentResponse in interface StateListener

Parameters:

x - the x coordinate of the mouse click

y - the y coordinate of the mouse click

Returns:

the response value if the mouse were click at the specified location, or Integer.MIN_VALUE if not selection is available

updateSelectedState

public void updateSelectedState()

Does nothing in this instance

Specified by:

updateSelectedState in interface StateListener

respond

public boolean respond()

Called by ClickListener to check if a response event should be sent to the parent form. The control can also use this event to do post click processing

Returns:

true if the parent is to be notified

getColor

public java.awt.Color getColor(int idx,
                               int callerClassId)

Gets an indexed color.

Parameters:

idx - The index of the color to get.

callerClassId - The ID of this calling class

Returns:

The color

See Also:

org.formaria.miniui.Frame#X_BUTTON

getStyle3D

public java.lang.String getStyle3D()

Get the style asociated with three dimensional objects/elements

Returns:

the style name

getStyleShade

public java.lang.String getStyleShade()

Get the style asociated with shaded elements

Returns:

the style name

setStyle

public void setStyle(java.lang.String newStyle)

Set the style asociated with shaded elements, background and text colors

Parameters:

newStyle - the style name

setStyle3D

public void setStyle3D(java.lang.String newStyle)

Get the style asociated with three dimensional objects/elements

Parameters:

newStyle - the style name

setStyleShade

public void setStyleShade(java.lang.String newStyle)

Set the style asociated with shaded elements, frame color

Parameters:

newStyle - the style name

setText

public void setText(java.lang.String newText)

Sets the control's text. Used to localize the control.

Specified by:

setText in interface TextHolder

Parameters:

newText - The new text to display.

setOutputField

public void setOutputField(TextHolder of)

Sets a text field in which to display the key value.

Parameters:

of - the output text field

clear

public void clear()

Clears the output value.

getValue

public java.lang.String getValue()

Gets the output value

Returns:

the keyed value

getText

public java.lang.String getText()

Gets the output value

Specified by:

getText in interface TextHolder

Returns:

the keyed value

setValue

public void setValue(java.lang.String newValue)

Sets the output value

setMaxLength

public void setMaxLength(int len)

Sets the maximum length of the output value

Parameters:

len - the new maximum length

setMinLength

public void setMinLength(int len)

Sets the minimum length of the output value

Parameters:

len - the new minimum length