jcontrol.ui.vole.menu
Class Menu

java.lang.Object
  |
  +--jcontrol.ui.vole.Component
        |
        +--jcontrol.ui.vole.menu.Menu

All Implemented Interfaces:

MenuInterface

Direct Known Subclasses:

BigImageMenu, MenuBar, MultiImageMenu, TextMenu

public abstract class Menu

extends Component

implements MenuInterface

The abstract class Menu is the superclass for graphical menus.

(C) DOMOLOGIC Home Automation GmbH 2003

Author:

Marcus Timmermann

Field Summary

protected int	activeIndex
protected java.util.Vector	inactives
protected java.util.Vector	items
protected ActionListener	listener
protected int	oldActiveIndex

Fields inherited from class jcontrol.ui.vole.Component

focusOwner, font, g, height, parent, visible, width, x, y

Constructor Summary

Menu(int x, int y, int width, int height)

Method Summary

int	addMenuItem(java.lang.String item) Adds a menu item to this menu.
int	addMenuItem(java.lang.String item, int pos) Adds a menu item to this menu at the specified position.
void	enableMenuItem(java.lang.String item, boolean onoff) Changes the active state of a menu item in this menu.
int	getActiveItemCount() Returns the number of active menu items.
int	getSelectedIndex() Returns the index of the selected menu item.
protected boolean	hasNextOrPrev(boolean updown, int index) Checks if the specified menu item has an active predecessor or successor.
boolean	isMenuItemEnabled(java.lang.String item) Returns the active state of the specified menu item.
boolean	onKeyEvent(KeyEvent e) If a KeyEvent accurs, this method is called.
void	paint() Paints the whole menu.
protected abstract void	paint(boolean all)
void	remove() Removes this menu from the screen.
void	removeMenuItem(java.lang.String item) Removes a menu item from this menu.
boolean	select(int index) Selects the specified menu item.
boolean	select(java.lang.String item) Selects the specified menu item.
protected int	selectNextOrPrev(boolean updown) Selects the next or previous menu item in this menu.
void	setActionListener(ActionListener listener) Set the ActionListener for this menu.
void	setParent(Container parent) Sets the parent Container.

Methods inherited from class jcontrol.ui.vole.Component

getBounds, getParent, isVisible, onActionEvent, removeFocus, requestFocus, setBounds, setFont, setGraphics, setLocation, setVisible, transferFocus, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, notifyAll, wait

Methods inherited from interface jcontrol.ui.vole.menu.MenuInterface

setGraphics

Field Detail

activeIndex

protected int activeIndex

inactives

protected java.util.Vector inactives

items

protected java.util.Vector items

listener

protected ActionListener listener

oldActiveIndex

protected int oldActiveIndex

Constructor Detail

Menu

public Menu(int x,
            int y,
            int width,
            int height)

Method Detail

addMenuItem

public int addMenuItem(java.lang.String item)

Adds a menu item to this menu.

Specified by:

addMenuItem in interface MenuInterface

Parameters:

item - the name of the menu item, can even specify an image name

Returns:

the index of the new menu item

addMenuItem

public int addMenuItem(java.lang.String item,
                       int pos)

Adds a menu item to this menu at the specified position.

Specified by:

addMenuItem in interface MenuInterface

Parameters:

item - the name of the menu item, can even specify an image name

pos - the position

Returns:

the index of the new menu item

enableMenuItem

public void enableMenuItem(java.lang.String item,
                           boolean onoff)

Changes the active state of a menu item in this menu.

Specified by:

enableMenuItem in interface MenuInterface

Parameters:

item - the name to the menu item

onoff - enable or disable

getActiveItemCount

public int getActiveItemCount()

Returns the number of active menu items.

Specified by:

getActiveItemCount in interface MenuInterface

Returns:

The numer of active menu items.

getSelectedIndex

public int getSelectedIndex()

Returns the index of the selected menu item.

Specified by:

getSelectedIndex in interface MenuInterface

Returns:

The index of the selected menu item.

hasNextOrPrev

protected boolean hasNextOrPrev(boolean updown,
                                int index)

Checks if the specified menu item has an active predecessor or successor.

Parameters:

updown - if true, check for a successor, for a predecessor otherwise

index - the index of the menu item

Returns:

true if the specified menu item has an active successor/predecessor, false otherwise.

isMenuItemEnabled

public boolean isMenuItemEnabled(java.lang.String item)

Returns the active state of the specified menu item.

Specified by:

isMenuItemEnabled in interface MenuInterface

Parameters:

item - the menu item

Returns:

boolean the active state of the menu item

onKeyEvent

public boolean onKeyEvent(KeyEvent e)

If a KeyEvent accurs, this method is called.

Specified by:

onKeyEvent in interface MenuInterface

Overrides:

onKeyEvent in class Component

Parameters:

e - The KeyEvent.

Returns:

false if the KeyEvent was consumed, true otherwise.

paint

public void paint()

Paints the whole menu.

Specified by:

paint in interface MenuInterface

Overrides:

paint in class Component

See Also:

paint()

paint

protected abstract void paint(boolean all)

remove

public void remove()

Removes this menu from the screen.

Specified by:

remove in interface MenuInterface

Overrides:

remove in class Component

removeMenuItem

public void removeMenuItem(java.lang.String item)

Removes a menu item from this menu.

Specified by:

removeMenuItem in interface MenuInterface

Parameters:

item - the item to remove

select

public boolean select(int index)

Selects the specified menu item.

Specified by:

select in interface MenuInterface

Parameters:

index - the index of the item to select

Returns:

boolean true if the item has been selected successfully, false otherwise

select

public boolean select(java.lang.String item)

Selects the specified menu item.

Specified by:

select in interface MenuInterface

Parameters:

item - the item to select

Returns:

boolean true if the item has been selected successfully, false otherwise

selectNextOrPrev

protected int selectNextOrPrev(boolean updown)

Selects the next or previous menu item in this menu.

Parameters:

updown - if true, select the next item, the previous otherwise

Returns:

int the index of the selected menu item

setActionListener

public void setActionListener(ActionListener listener)

Set the ActionListener for this menu. It will receive action events when a menu item is selected.

Parameters:

listener - The action listener to associate with this menu.

setParent

public void setParent(Container parent)

Sets the parent Container.

Specified by:

setParent in interface MenuInterface

Overrides:

setParent in class Component

Parameters:

parent - the Container to be the parent Object