com.github.ilyes4j.gwt.mdl.extensions.menus

Class Dropdown

java.lang.Object

com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.Widget

com.google.gwt.user.client.ui.Composite

com.github.ilyes4j.gwt.mdl.extensions.menus.Dropdown

All Implemented Interfaces:

IMenu, com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.shared.HasHandlers, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.ui.HasVisibility, com.google.gwt.user.client.ui.IsRenderable, com.google.gwt.user.client.ui.IsWidget

public class Dropdown
extends com.google.gwt.user.client.ui.Composite
implements IMenu

Is a MenuCombo that has the ability to store the selected item. When Dropdown is initially setup, the first enabled item is set to be the selected item by default.

Author:

Mohamed Ilyes DIMASSI

Nested Class Summary

Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject

com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled

Field Summary

Fields inherited from class com.google.gwt.user.client.ui.UIObject

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Constructor and Description
Dropdown() Setup a default dropdown with a raised action Button and a menu anchored to the bottom-left of the action button.

Method Summary

Methods

Modifier and Type	Method and Description
void	addItem(String item) Has the same effect as Dropdown.addItem(item , true).
void	addItem(String item, boolean enabled) Has the same effect as Dropdown.addItem(item , item, enabled).
void	addItem(String value, String text) Shortcut for addItem(String, boolean) that adds an enabled item to the menu.
void	addItem(String text, String value, boolean enabled) Adds a new option to the list of options in the menu.
void	addItemClickListener(Menu.ItemClickListener listener) When an object needs to be notified upon a MenuItem click, it must be be registered to the Menu as an Menu.ItemClickListener .
void	clearMenu() Remove all items from the menu.
int	getItemCount() Returns the items count in a menu.
String	getItemText(int index) return the text of the item located at the position provided as input.
int	getSelected()
int	getSelectedIndex()
String	getValue(int index) return the value of the item located at the position provided as input.
boolean	isEnabled(int index) Modify the enabled state of an item.
void	setAnchor(MenuAnchor anchor) Sets the position of the Menu on the screen related to its associated action button using one of the available anchoring options provided by MenuAnchor.
boolean	setEnabled(int index, boolean enabled) Modify the enabled state of an item.
void	setSelected(int index) Set a selected item of the dropdown programmatically.

Methods inherited from class com.google.gwt.user.client.ui.Composite

claimElement, getWidget, initializeClaimedElement, initWidget, isAttached, onAttach, onBrowserEvent, onDetach, render, render, resolvePotentialElement, setWidget

Methods inherited from class com.google.gwt.user.client.ui.Widget

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getHandlerCount, getLayoutData, getParent, isOrWasAttached, onLoad, onUnload, removeFromParent, setLayoutData, sinkEvents, unsinkEvents

Methods inherited from class com.google.gwt.user.client.ui.UIObject

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, setElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkBitlessEvent, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

Dropdown

public Dropdown()

Setup a default dropdown with a raised action Button and a menu anchored to the bottom-left of the action button.

Method Detail

setAnchor

public final void setAnchor(MenuAnchor anchor)

Description copied from interface: IMenu

Sets the position of the Menu on the screen related to its associated action button using one of the available anchoring options provided by MenuAnchor.

An extra care should be taken when anchoring the menu. According to this thread , the menu's parent need a position:relative in order for the menu to be anchored correctly.

Specified by:

setAnchor in interface IMenu

Parameters:

anchor - the requested Anchor position for the Menu .

clearMenu

public final void clearMenu()

Description copied from interface: IMenu

Remove all items from the menu.

Specified by:

clearMenu in interface IMenu

addItemClickListener

public final void addItemClickListener(Menu.ItemClickListener listener)

Description copied from interface: IMenu

When an object needs to be notified upon a MenuItem click, it must be be registered to the Menu as an Menu.ItemClickListener .

In order to receive item click notifications, the object should :

1. Implement the Menu.ItemClickListener interface
2. Define the actions that should be performed when a MenuItem is clicked inside Menu.ItemClickListener.onItemClicked(ItemClickEvent)
3. Call Menu.addItemClickListener(ItemClickListener) to register itself to the menu and receive click notifications

Specified by:

addItemClickListener in interface IMenu

Parameters:

listener - The object to be notified when a MenuItem is clicked.

See Also:

Menu.ItemClickListener

getItemCount

public final int getItemCount()

Description copied from interface: IMenu

Returns the items count in a menu.

Specified by:

getItemCount in interface IMenu

Returns:

the items count in a menu

getItemText

public final String getItemText(int index)

Description copied from interface: IMenu

return the text of the item located at the position provided as input.

Specified by:

getItemText in interface IMenu

Parameters:

index - the position of the item

Returns:

the text of the item at input position

getValue

public final String getValue(int index)

Description copied from interface: IMenu

return the value of the item located at the position provided as input.

Specified by:

getValue in interface IMenu

Parameters:

index - the position of the item

Returns:

the value of the item at input position

setEnabled

public final boolean setEnabled(int index,
                 boolean enabled)

Description copied from interface: IMenu

Modify the enabled state of an item. The position of the item is provided as input

Specified by:

setEnabled in interface IMenu

Parameters:

index - the position of the item in the item list of the menu

enabled - the state to be set for the item

Returns:

true if the state was modified, false otherwise.

isEnabled

public final boolean isEnabled(int index)

Description copied from interface: IMenu

Modify the enabled state of an item. The position of the item is provided as input

Specified by:

isEnabled in interface IMenu

Parameters:

index - the position of the item in the item list of the menu

Returns:

true if the item is enabled, false otherwise.

addItem

public final void addItem(String text,
           String value,
           boolean enabled)

Description copied from interface: IMenu

Adds a new option to the list of options in the menu.

Specified by:

addItem in interface IMenu

Parameters:

text - The text to be displayed

value - The value to be added

enabled - Defines whether the option can be chosen or not.

addItem

public final void addItem(String item,
           boolean enabled)

Has the same effect as Dropdown.addItem(item , item, enabled).

Parameters:

item - the value and text of the item to be added

enabled - the state of the item to be added

addItem

public final void addItem(String item)

Has the same effect as Dropdown.addItem(item , true).

Parameters:

item - the value and text of the item to be added

addItem

public final void addItem(String value,
           String text)

Shortcut for addItem(String, boolean) that adds an enabled item to the menu.

Parameters:

value - the value of the item to be added.

text - the text of the item to be added.

getSelectedIndex

public final int getSelectedIndex()

Returns:

the index of the currently selected item

setSelected

public final void setSelected(int index)

Set a selected item of the dropdown programmatically. If the chosen item is disabled, the element is not selected

Parameters:

index - the index of the item to be selected

getSelected

public final int getSelected()

Returns:

returns the currently selected item