org.xith3d.ui.hud.listeners
Class WidgetEventsReceiverAdapter<ListItem extends Widget>

java.lang.Object
  org.xith3d.ui.hud.listeners.WidgetEventsReceiverAdapter<ListItem>

All Implemented Interfaces:

ButtonListener, DialogListener, ListSelectionListener<ListItem>, ScrollbarListener, SliderListener, WidgetContainerListener, WidgetFocusListener, WidgetInputListener, WidgetLocationListener, WidgetSizeListener, WidgetStateListener, WidgetVisibilityListener, WindowListener

public abstract class WidgetEventsReceiverAdapter<ListItem extends Widget>
extends java.lang.Object
implements WidgetInputListener, WidgetFocusListener, WidgetLocationListener, WidgetSizeListener, WidgetVisibilityListener, WidgetContainerListener, ButtonListener, WidgetStateListener, ListSelectionListener<ListItem>, ScrollbarListener, SliderListener, WindowListener, DialogListener

If a Widget makes use of other Widgets to be built and these Widgets produce events, that are to be catched be the Widget only, then you should create an inner class and let it extend this class to catch them, since it already implements all known Widget-Listeners (with empty method stubs).

Constructor Summary

WidgetEventsReceiverAdapter()

Method Summary

void	onButtonClicked(Button button, java.lang.Object userObject) This event is fired when a Button was clicked.
void	onButtonStateChanged(StateButton stateButton, StateButton.State state, java.lang.Object userObject) This event will be fired when a StateButton's state has changed.
void	onControllerAxisChanged(Widget widget, org.jagatoo.input.devices.components.ControllerAxis axis, int axisDelta) This event is fired when a ControllerAxis has changed and this Widget is the currently focussed one.
void	onControllerButtonPressed(Widget widget, org.jagatoo.input.devices.components.ControllerButton button) This event is fired when a ControllerButton has been pressed and this Widget is the currently focussed one.
void	onControllerButtonReleased(Widget widget, org.jagatoo.input.devices.components.ControllerButton button) This event is fired when a ControllerButton has been released and this Widget is the currently focussed one.
void	onDialogClosed(Dialog dialog, java.lang.Object closeCommand) This event is fired when a Dialog is closed.
void	onFocusGained(Widget widget) This event is fired, when the focus is gained to a Widget.
void	onFocusLost(Widget widget) This event is fired, when the focus is lost by a Widget.
void	onInputStateChanged(Widget widget, org.jagatoo.input.devices.components.DeviceComponent comp, int delta, int state, boolean isTopMost, boolean hasFocus) This event is fired when the state of any DeviceComponent has changed.
void	onKeyPressed(Widget widget, org.jagatoo.input.devices.components.Key key, long when) This event is fired, when a key is pressed on a focused Widget.
void	onKeyReleased(Widget widget, org.jagatoo.input.devices.components.Key key, long when) This event is fired, when a key is released on a focused Widget.
void	onKeyTyped(Widget widget, char ch, long when) This event is fired when a key is typed on the keyboard.
void	onListItemClicked(AbstractList<ListItem> list, ListItem item) This event is fired, when a List Item is clicked.
void	onListSelectionChanged(AbstractList<ListItem> list, ListItem oldSelection, ListItem newSelection) This event is fired, when the List's selection has changed.
void	onMouseButtonPressed(Widget widget, org.jagatoo.input.devices.components.MouseButton button, int x, int y, long when, long lastWhen, boolean isTopMost, boolean hasFocus) This event is fired, when a mouse button is pressed on a focused Widget.
void	onMouseButtonReleased(Widget widget, org.jagatoo.input.devices.components.MouseButton button, int x, int y, long when, long lastWhen, boolean isTopMost, boolean hasFocus) This event is fired, when a mouse button is released on a focused Widget.
void	onMouseEntered(Widget widget, boolean isTopMost, boolean hasFocus) This method is called when the mouse entered the Widget area
void	onMouseLeft(Widget widget, boolean isTopMost, boolean hasFocus) This method is called when the mouse left the Widget area
void	onMouseMoved(Widget widget, int x, int y, int buttonsState, long when, boolean isTopMost, boolean hasFocus) This event is fired, when the mouse is moved on a Widget.
void	onMouseStopped(Widget widget, int x, int y, long when, boolean isTopMost, boolean hasFocus) This event is fired, when the mouse position has not been changed on this Widget for a certain amount of time.
void	onMouseUnbound(Widget widget) This event is fired, when the mouse is released.
void	onMouseWheelMoved(Widget widget, int delta, boolean isPageMove, int x, int y, long when, boolean isTopMost) This event is fired, when the mouse wheel is moved on a Widget.
void	onScrollbarValueChanged(Scrollbar scrollbar, int newValue, Scrollbar.Direction direction) This event is fired when the value of a Scrollbar has changed.
void	onSliderValueChanged(Slider slider, int newValue) This event is fired when the value of a Slider has changed.
void	onWidgetAddedToContainer(WidgetContainer container, Widget widget) This event is fired, when a Widget is added to a WidgetContainer.
void	onWidgetAddedToHUD(HUD hud, Widget widget) This event is fired, when a Widget is added to a WidgetContainer and the container itself is already added to the HUD or is the HUD itself.
void	onWidgetDragStarted(Widget widget) This event is fired when a Widget is started to be dragged.
void	onWidgetDragStopped(Widget widget) This event is fired when a Widget is stopped to be dragged.
void	onWidgetLocationChanged(Widget widget, float oldLeft, float oldTop, float newLeft, float newTop) This event is fired when a Widget's location has changed.
void	onWidgetRemovedFromContainer(WidgetContainer container, Widget widget) This event is fired, when a Widget is removed from a WidgetContainer.
void	onWidgetSizeChanged(Widget widget, float oldWidth, float oldHeight, float newWidth, float newHeight) This event is fired when a Widget's size has changed.
void	onWidgetVisibilityChanged(Widget widget, boolean isVisible) This event is fired when a Widget's visibility state has changed.
void	onWindowClosed(Window frame) This event is fired when a Window is closed.
void	onWindowHidden(Window frame) This event is fired when a Window is set invisible.
void	onWindowShown(Window frame) This event is fired when a Window is set visible.

Methods inherited from class java.lang.Object

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

Constructor Detail

WidgetEventsReceiverAdapter

public WidgetEventsReceiverAdapter()

Method Detail

onKeyPressed

public void onKeyPressed(Widget widget,
                         org.jagatoo.input.devices.components.Key key,
                         long when)

This event is fired, when a key is pressed on a focused Widget.

Specified by:

onKeyPressed in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

key - the key that was pressed

when - the gameTime of the key event

onKeyReleased

public void onKeyReleased(Widget widget,
                          org.jagatoo.input.devices.components.Key key,
                          long when)

This event is fired, when a key is released on a focused Widget.

Specified by:

onKeyReleased in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

key - the key that was released

when - the gameTime of the key event

onKeyTyped

public void onKeyTyped(Widget widget,
                       char ch,
                       long when)

This event is fired when a key is typed on the keyboard.

Specified by:

onKeyTyped in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

ch - the typed key's character

when - the gameTime of the key event

onMouseButtonPressed

public void onMouseButtonPressed(Widget widget,
                                 org.jagatoo.input.devices.components.MouseButton button,
                                 int x,
                                 int y,
                                 long when,
                                 long lastWhen,
                                 boolean isTopMost,
                                 boolean hasFocus)

This event is fired, when a mouse button is pressed on a focused Widget.

Specified by:

onMouseButtonPressed in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

button - the button that was pressed

x - the current mouse x position

y - the current mouse y position

when - the gameTime of the mouse event

lastWhen - the milli-time when the button has last been pressed

isTopMost - is this Widget topMost

hasFocus - is this Widget focused

onMouseButtonReleased

public void onMouseButtonReleased(Widget widget,
                                  org.jagatoo.input.devices.components.MouseButton button,
                                  int x,
                                  int y,
                                  long when,
                                  long lastWhen,
                                  boolean isTopMost,
                                  boolean hasFocus)

This event is fired, when a mouse button is released on a focused Widget.

Specified by:

onMouseButtonReleased in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

button - the button that was released

x - the current mouse x position

y - the current mouse y position

when - the gameTime of the mouse event

lastWhen - the milli-time when the button has last been released

isTopMost - is this Widget topMost

hasFocus - is this Widget focused

onMouseMoved

public void onMouseMoved(Widget widget,
                         int x,
                         int y,
                         int buttonsState,
                         long when,
                         boolean isTopMost,
                         boolean hasFocus)

This event is fired, when the mouse is moved on a Widget.

Specified by:

onMouseMoved in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

x - the new X coordinate

y - the new Y coordinate

buttonsState - the buttons' state bitmask

when - the gameTime of the mouse event

isTopMost - is this Widget topMost

hasFocus - is this Widget focused

onMouseStopped

public void onMouseStopped(Widget widget,
                           int x,
                           int y,
                           long when,
                           boolean isTopMost,
                           boolean hasFocus)

This event is fired, when the mouse position has not been changed on this Widget for a certain amount of time.

Specified by:

onMouseStopped in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

x - the new X coordinate

y - the new Y coordinate

when - the gameTime of the mouse event

isTopMost - is this Widget topMost

hasFocus - is this Widget focused

onMouseWheelMoved

public void onMouseWheelMoved(Widget widget,
                              int delta,
                              boolean isPageMove,
                              int x,
                              int y,
                              long when,
                              boolean isTopMost)

This event is fired, when the mouse wheel is moved on a Widget.

Specified by:

onMouseWheelMoved in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

delta - a positive value when the wheel was moved up

isPageMove - true, if whole pages are to be scrolled with this wheel move

x - the current mouse x position

y - the current mouse y position

when - the gameTime of the mouse event

isTopMost - is this Widget topMost

onMouseEntered

public void onMouseEntered(Widget widget,
                           boolean isTopMost,
                           boolean hasFocus)

This method is called when the mouse entered the Widget area

Specified by:

onMouseEntered in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

isTopMost - is this Widget topMost

hasFocus - is this Widget focused

onMouseLeft

public void onMouseLeft(Widget widget,
                        boolean isTopMost,
                        boolean hasFocus)

This method is called when the mouse left the Widget area

Specified by:

onMouseLeft in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

isTopMost - is this Widget topMost

hasFocus - is this Widget focused

onMouseUnbound

public void onMouseUnbound(Widget widget)

This event is fired, when the mouse is released. onMouseMoved will not be called on the Widget anymore, when the mouse is not over it.

Specified by:

onMouseUnbound in interface WidgetInputListener

Parameters:

widget - the Widget, which was unbound from the mouse

onControllerButtonPressed

public void onControllerButtonPressed(Widget widget,
                                      org.jagatoo.input.devices.components.ControllerButton button)

This event is fired when a ControllerButton has been pressed and this Widget is the currently focussed one.

Specified by:

onControllerButtonPressed in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

button - the pressed button

onControllerButtonReleased

public void onControllerButtonReleased(Widget widget,
                                       org.jagatoo.input.devices.components.ControllerButton button)

This event is fired when a ControllerButton has been released and this Widget is the currently focussed one.

Specified by:

onControllerButtonReleased in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

button - the released button

onControllerAxisChanged

public void onControllerAxisChanged(Widget widget,
                                    org.jagatoo.input.devices.components.ControllerAxis axis,
                                    int axisDelta)

This event is fired when a ControllerAxis has changed and this Widget is the currently focussed one.

Specified by:

onControllerAxisChanged in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

axis - the changed axis

onInputStateChanged

public void onInputStateChanged(Widget widget,
                                org.jagatoo.input.devices.components.DeviceComponent comp,
                                int delta,
                                int state,
                                boolean isTopMost,
                                boolean hasFocus)

Description copied from interface: WidgetInputListener

This event is fired when the state of any DeviceComponent has changed.

Specified by:

onInputStateChanged in interface WidgetInputListener

Parameters:

widget - the Widget for which this event was fired

onFocusGained

public void onFocusGained(Widget widget)

This event is fired, when the focus is gained to a Widget.

Specified by:

onFocusGained in interface WidgetFocusListener

Parameters:

widget - the Widget, which was gained the focus

onFocusLost

public void onFocusLost(Widget widget)

This event is fired, when the focus is lost by a Widget.

Specified by:

onFocusLost in interface WidgetFocusListener

Parameters:

widget - the Widget, which has lost the focus

onWidgetDragStarted

public void onWidgetDragStarted(Widget widget)

This event is fired when a Widget is started to be dragged.

Specified by:

onWidgetDragStarted in interface WidgetLocationListener

Parameters:

widget - the Widget, which is dragged

onWidgetDragStopped

public void onWidgetDragStopped(Widget widget)

This event is fired when a Widget is stopped to be dragged.

Specified by:

onWidgetDragStopped in interface WidgetLocationListener

Parameters:

widget - the Widget, which was dragged

onWidgetLocationChanged

public void onWidgetLocationChanged(Widget widget,
                                    float oldLeft,
                                    float oldTop,
                                    float newLeft,
                                    float newTop)

This event is fired when a Widget's location has changed.

Specified by:

onWidgetLocationChanged in interface WidgetLocationListener

Parameters:

widget - the Widget, which's location has changed

oldLeft - the old left coordinate of the Widget

oldTop - the old top coordinate of the Widget

newLeft - the new left coordinate of the Widget

newTop - the new top coordinate of the Widget

onWidgetSizeChanged

public void onWidgetSizeChanged(Widget widget,
                                float oldWidth,
                                float oldHeight,
                                float newWidth,
                                float newHeight)

This event is fired when a Widget's size has changed.

Specified by:

onWidgetSizeChanged in interface WidgetSizeListener

Parameters:

widget - the Widget, which's size has changed

oldWidth - the new width of the Widget

oldHeight - the new height of the Widget

newWidth - the new width of the Widget

newHeight - the new height of the Widget

onWidgetVisibilityChanged

public void onWidgetVisibilityChanged(Widget widget,
                                      boolean isVisible)

This event is fired when a Widget's visibility state has changed.

Specified by:

onWidgetVisibilityChanged in interface WidgetVisibilityListener

onWidgetAddedToContainer

public void onWidgetAddedToContainer(WidgetContainer container,
                                     Widget widget)

This event is fired, when a Widget is added to a WidgetContainer.

Specified by:

onWidgetAddedToContainer in interface WidgetContainerListener

Parameters:

container - the WidgetContainer, the Widget is added to

widget - the Widget, which is added to a WidgetContainer

onWidgetAddedToHUD

public void onWidgetAddedToHUD(HUD hud,
                               Widget widget)

This event is fired, when a Widget is added to a WidgetContainer and the container itself is already added to the HUD or is the HUD itself.

Specified by:

onWidgetAddedToHUD in interface WidgetContainerListener

Parameters:

hud - the HUD, the Widget is added to

widget - the Widget, which is added to a WidgetContainer

onWidgetRemovedFromContainer

public void onWidgetRemovedFromContainer(WidgetContainer container,
                                         Widget widget)

This event is fired, when a Widget is removed from a WidgetContainer.

Specified by:

onWidgetRemovedFromContainer in interface WidgetContainerListener

Parameters:

container - the WidgetContainer, the Widget is removed from

widget - the Widget, which is removed from a WidgetContainer

onButtonClicked

public void onButtonClicked(Button button,
                            java.lang.Object userObject)

This event is fired when a Button was clicked.

Specified by:

onButtonClicked in interface ButtonListener

Parameters:

button - the clicked Button

userObject - the Button's userObject

onButtonStateChanged

public void onButtonStateChanged(StateButton stateButton,
                                 StateButton.State state,
                                 java.lang.Object userObject)

This event will be fired when a StateButton's state has changed.

Specified by:

onButtonStateChanged in interface WidgetStateListener

Parameters:

stateButton - the StateButton, which's state has changed

state - the new state

userObject - the StateButton's user-object

onListItemClicked

public void onListItemClicked(AbstractList<ListItem> list,
                              ListItem item)

This event is fired, when a List Item is clicked.

Specified by:

onListItemClicked in interface ListSelectionListener<ListItem extends Widget>

Parameters:

list - the list, that fired this event

item - the clicked Item

onListSelectionChanged

public void onListSelectionChanged(AbstractList<ListItem> list,
                                   ListItem oldSelection,
                                   ListItem newSelection)

This event is fired, when the List's selection has changed.

Specified by:

onListSelectionChanged in interface ListSelectionListener<ListItem extends Widget>

Parameters:

list - the list, that fired this event

oldSelection - the pre-event selected Item

newSelection - the new current selected Item

onScrollbarValueChanged

public void onScrollbarValueChanged(Scrollbar scrollbar,
                                    int newValue,
                                    Scrollbar.Direction direction)

This event is fired when the value of a Scrollbar has changed.

Specified by:

onScrollbarValueChanged in interface ScrollbarListener

Parameters:

scrollbar - the Scrollbar, which's value has changed

newValue - the new (current) value of the Scrollbar

direction - the direction in which the scolling happened

onSliderValueChanged

public void onSliderValueChanged(Slider slider,
                                 int newValue)

This event is fired when the value of a Slider has changed.

Specified by:

onSliderValueChanged in interface SliderListener

Parameters:

slider - the Slider, which's value has changed

newValue - the new (current) value of the Slider

onWindowClosed

public void onWindowClosed(Window frame)

This event is fired when a Window is closed.

Specified by:

onWindowClosed in interface WindowListener

Parameters:

frame - the closed Window

onWindowHidden

public void onWindowHidden(Window frame)

This event is fired when a Window is set invisible.

Specified by:

onWindowHidden in interface WindowListener

Parameters:

frame - the hidden Window

onWindowShown

public void onWindowShown(Window frame)

This event is fired when a Window is set visible.

Specified by:

onWindowShown in interface WindowListener

Parameters:

frame - the shown Window

onDialogClosed

public void onDialogClosed(Dialog dialog,
                           java.lang.Object closeCommand)

This event is fired when a Dialog is closed.

Specified by:

onDialogClosed in interface DialogListener

Parameters:

dialog - the Dialog that was closed

closeCommand - the close-command