com.extjs.gxt.ui.client.widget.menu
Class Menu

java.lang.Object
  com.google.gwt.user.client.ui.UIObject
      com.google.gwt.user.client.ui.Widget
          com.extjs.gxt.ui.client.widget.Component
              com.extjs.gxt.ui.client.widget.BoxComponent
                  com.extjs.gxt.ui.client.widget.Container<Item>
                      com.extjs.gxt.ui.client.widget.menu.Menu

All Implemented Interfaces:

Observable, com.google.gwt.user.client.EventListener

Direct Known Subclasses:

DateMenu

public class Menu
extends Container<Item>

A menu component.

Events:

BeforeShow : MenuEvent(menu)

Fires before this menu is displayed. Listener can set the doit field to false to cancel the menu being displayed.

• menu : this

Show : MenuEvent(menu)

Fires after this menu is displayed.

• menu : this

BeforeHide : MenuEvent(menu)

Fired before the menu is hidden. Listener can set the doit field to false to cancel the menu being hidden.

• menu : this

Hide : MenuEvent(menu)

Fires after this menu is hidden.

• menu : this

BeforeAdd : MenuEvent(menu, item, index)

Fires before a item is added or inserted. Listeners can set the doit field to false to cancel the action.

• menu : this
• item : the item being added
• index : the index at which the item will be added

BeforeRemove : MenuEvent(menu, item)

Fires before a item is removed. Listeners can set the doit field to false to cancel the action.

• menu : this
• item : the item being removed

Add : MenuEvent(menu, item, index)

Fires after a item has been added or inserted.

• menu : this
• item : the item that was added
• index : the index at which the item will be added

Remove : MenuEvent(menu, item)

Fires after a item has been removed.

• menu : this
• item : the item being removed

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

Menu()
Creates a new menu.

Method Summary

boolean	add(Item item) Adds a item to the menu.
java.lang.String	getDefaultAlign() Returns the default alignment.
int	getMinWidth() Returns the menu's minimum width.
Item	getParentItem() Returns the menu's parent item.
Shadow.ShadowPosition	getShadowPosition() Returns the shadow position.
java.lang.String	getSubMenuAlign() Returns the sub menu alignment.
void	hide() Hides the menu.
Menu	hide(boolean deep) Hides this menu and optionally all parent menus
boolean	insert(Item item, int index) Inserts an item into the menu.
boolean	isConstrainViewport() Returns true if constrain to viewport is enabled.
boolean	isVisible() Returns true if the component is visible.
void	onComponentEvent(ComponentEvent ce) Any events a component receives will be forwarded to this method.
boolean	remove(Item item) Removes a item from the menu.
void	setConstrainViewport(boolean constrainViewport) Sets whether the menu should be constrained to the viewport when shown.
void	setDefaultAlign(java.lang.String defaultAlign) Sets the default El.alignTo(com.google.gwt.user.client.Element, java.lang.String, int[]) anchor position value for this menu relative to its element of origin (defaults to "tl-bl?").
void	setMinWidth(int minWidth) Sets he minimum width of the menu in pixels (defaults to 120).
void	setShadowPosition(Shadow.ShadowPosition shadowPosition) Sets the shadow position (defaults to SIDES).
void	setSubMenuAlign(java.lang.String subMenuAlign) The El.alignTo(com.google.gwt.user.client.Element, java.lang.String, int[]) anchor position value to use for submenus of this menu (defaults to "tl-tr-?").
void	show(com.google.gwt.user.client.Element elem, java.lang.String pos) Displays this menu relative to another element.
void	show(com.google.gwt.user.client.ui.Widget widget) Displays this menu relative to the widget using the default alignment.
void	showAt(int x, int y) Displays this menu at a specific xy position.

Methods inherited from class com.extjs.gxt.ui.client.widget.Container

findItem, getItem, getItemByItemId, getItemCount, getItems, getWidget, indexOf, iterator, removeAll, scrollIntoView

Methods inherited from class com.extjs.gxt.ui.client.widget.BoxComponent

getBounds, getHeight, getHeight, getPosition, getShadow, getSize, getWidth, getWidth, isAutoHeight, isAutoWidth, isDeferHeight, isShim, setAutoHeight, setAutoWidth, setBounds, setBounds, setDeferHeight, setHeight, setHeight, setPagePosition, setPagePosition, setPixelSize, setPosition, setShadow, setShim, setSize, setSize, setWidth, setWidth

Methods inherited from class com.extjs.gxt.ui.client.widget.Component

addListener, addStyleName, addWidgetListener, disable, disableEvents, disableTextSelection, el, enable, enableEvents, fireEvent, fireEvent, fireEvent, fly, focus, getBaseStyle, getBorders, getData, getData, getElement, getId, getItemId, getModel, getState, getToolTip, hideToolTip, isEnabled, isRendered, onBrowserEvent, recalculate, removeAllListeners, removeFromParent, removeListener, removeStyleName, removeWidgetListener, render, render, saveState, setBorders, setData, setData, setElement, setEnabled, setEnableState, setId, setIntStyleAttribute, setItemId, setStyleAttribute, setStyleName, setTitle, setToolTip, setToolTip, setVisible, show, toString

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

getParent, isAttached

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

addStyleDependentName, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getOffsetHeight, getOffsetWidth, getStyleName, getStylePrimaryName, getTitle, isVisible, removeStyleDependentName, setStylePrimaryName, setVisible, sinkEvents, unsinkEvents

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Menu

public Menu()

Creates a new menu.

Method Detail

add

public boolean add(Item item)

Adds a item to the menu.

Parameters:

item - the new item

getDefaultAlign

public java.lang.String getDefaultAlign()

Returns the default alignment.

Returns:

the default align

getMinWidth

public int getMinWidth()

Returns the menu's minimum width.

Returns:

the width

getParentItem

public Item getParentItem()

Returns the menu's parent item.

Returns:

the parent item

getShadowPosition

public Shadow.ShadowPosition getShadowPosition()

Returns the shadow position.

Returns:

the shadow position

getSubMenuAlign

public java.lang.String getSubMenuAlign()

Returns the sub menu alignment.

Returns:

the alignment

hide

public void hide()

Hides the menu.

Overrides:

hide in class Component

hide

public Menu hide(boolean deep)

Hides this menu and optionally all parent menus

Parameters:

deep - true to close all parent menus

Returns:

this

insert

public boolean insert(Item item,
                      int index)

Inserts an item into the menu.

Parameters:

item - the item to insert

index - the insert location

isConstrainViewport

public boolean isConstrainViewport()

Returns true if constrain to viewport is enabled.

Returns:

the contstrain to viewport state

isVisible

public boolean isVisible()

Description copied from class: Component

Returns true if the component is visible.

Overrides:

isVisible in class Component

onComponentEvent

public void onComponentEvent(ComponentEvent ce)

Description copied from class: Component

Any events a component receives will be forwarded to this method. Subclasses should override as needed. The Component.onBrowserEvent(com.google.gwt.user.client.Event) method should not be overridden or modified.

Overrides:

onComponentEvent in class Component

Parameters:

ce - the base event

remove

public boolean remove(Item item)

Removes a item from the menu.

Parameters:

item - the menu to remove

Returns:

true if the item was removed

setConstrainViewport

public void setConstrainViewport(boolean constrainViewport)

Sets whether the menu should be constrained to the viewport when shown. Only applies when using showAt(int, int).

Parameters:

constrainViewport - true to contrain

setDefaultAlign

public void setDefaultAlign(java.lang.String defaultAlign)

Sets the default El.alignTo(com.google.gwt.user.client.Element, java.lang.String, int[]) anchor position value for this menu relative to its element of origin (defaults to "tl-bl?").

Parameters:

defaultAlign - the default align

setMinWidth

public void setMinWidth(int minWidth)

Sets he minimum width of the menu in pixels (defaults to 120).

Parameters:

minWidth - the min width

setShadowPosition

public void setShadowPosition(Shadow.ShadowPosition shadowPosition)

Sets the shadow position (defaults to SIDES).

Parameters:

shadowPosition - the position

setSubMenuAlign

public void setSubMenuAlign(java.lang.String subMenuAlign)

The El.alignTo(com.google.gwt.user.client.Element, java.lang.String, int[]) anchor position value to use for submenus of this menu (defaults to "tl-tr-?").

Parameters:

subMenuAlign - the sub alignment

show

public void show(com.google.gwt.user.client.Element elem,
                 java.lang.String pos)

Displays this menu relative to another element.

Parameters:

elem - the element to align to

pos - the El.alignTo(com.google.gwt.user.client.Element, java.lang.String, int[]) anchor position to use in aligning to the element (defaults to defaultAlign)

show

public void show(com.google.gwt.user.client.ui.Widget widget)

Displays this menu relative to the widget using the default alignment.

Parameters:

widget - the align widget

showAt

public void showAt(int x,
                   int y)

Displays this menu at a specific xy position.

Parameters:

x - the x coordinate

y - the y coordinate