com.extjs.gxt.ui.client.widget.button
Class Button

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.button.Button

All Implemented Interfaces:

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

Direct Known Subclasses:

ButtonAdapter, FillButton, SplitButton, ToggleButton

public class Button
extends Component

A button component.

Events:

BeforeSelect : ButtonEvent(button, event)

Fires before this button is selected.

• button : this
• event : the dom event

Select : ButtonEvent(button, event)

Fires when this button is selected.

• button : this
• event : the dom event

MenuShow : ButtonEvent(button, item)

If this button has a menu, this event fires when it is shown.

• button : this
• menu : the menu

MenuHide : ButtonEvent(button, item)

If this button has a menu, this event fires when it is hidden.

• button : this
• menu : the menu

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

static Template

buttonTemplate Template used by buttons if a template is not provided.

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

DEBUG_ID_PREFIX

Constructor Summary

Button()
Creates a new button.

Button(java.lang.String text)
Creates a new button with the given text.

Button(java.lang.String text, SelectionListener listener)
Creates a new button with the given text and specified selection listener.

Method Summary

void	addSelectionListener(SelectionListener listener) Adds a selection listener.
java.lang.String	getIconStyle() Returns the button's icon style.
Menu	getMenu() Returns the button's menu (if it has one).
java.lang.String	getMenuAlign() Returns the button's menu alignment.
int	getMinWidth()
boolean	getMouseEvents() Retutns true if mouse over effect is disabled.
java.lang.String	getText() Returns the button's text.
java.lang.String	getType()
void	hideMenu() Hide this button's menu (if it has one).
void	onComponentEvent(ComponentEvent ce) Any events a component receives will be forwarded to this method.
void	removeSelectionListener(SelectionListener listener) Removes a previously added listener.
void	setIconStyle(java.lang.String iconStyle) Sets the button's icon style.
void	setMenu(Menu menu) Sets the button's menu.
void	setMenuAlign(java.lang.String menuAlign) Sets the position to align the menu to, see El.alignTo(com.google.gwt.user.client.Element, java.lang.String, int[]) for more details (defaults to 'tl-bl?', pre-render).
void	setMinWidth(int minWidth) Sets he minimum width for this button (used to give a set of buttons a common width)
void	setMouseEvents(boolean handleMouseEvents) False to disable visual cues on mouseover, mouseout and mousedown (defaults to true).
void	setTabIndex(int index) Sets the button's tab index.
void	setText(java.lang.String text) Sets the button's text.
void	setType(java.lang.String type) Submit, reset or button (defaults to 'button').
void	showMenu() Show this button's menu (if it has one).

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

addListener, addPlugin, addStyleName, addWidgetListener, disable, disableEvents, disableTextSelection, el, enable, enableEvents, fireEvent, fireEvent, fireEvent, fly, focus, getBaseStyle, getBorders, getData, getData, getElement, getId, getItemId, getModel, getState, getToolTip, hide, hideToolTip, isDisabledEvents, isEnabled, isRendered, isVisible, onBrowserEvent, recalculate, removeAllListeners, removeFromParent, removeListener, removeStyleName, removeWidgetListener, render, render, saveState, setBorders, setData, setData, setElement, setEnabled, setEnableState, setHeight, setId, setIntStyleAttribute, setItemId, setPixelSize, setSize, setStyleAttribute, setStyleName, setTitle, setToolTip, setToolTip, setVisible, setWidth, show, sinkEvents, 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, unsinkEvents

Methods inherited from class java.lang.Object

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

Field Detail

buttonTemplate

public static Template buttonTemplate

Template used by buttons if a template is not provided.

Constructor Detail

Button

public Button()

Creates a new button.

Button

public Button(java.lang.String text)

Creates a new button with the given text.

Parameters:

text - the button text

Button

public Button(java.lang.String text,
              SelectionListener listener)

Creates a new button with the given text and specified selection listener.

Parameters:

text - the button's text

listener - the selection listener

Method Detail

addSelectionListener

public void addSelectionListener(SelectionListener listener)

Adds a selection listener.

Parameters:

listener - the listener to add

getIconStyle

public java.lang.String getIconStyle()

Returns the button's icon style.

Returns:

the icon style

getMenu

public Menu getMenu()

Returns the button's menu (if it has one).

Returns:

the menu

getMenuAlign

public java.lang.String getMenuAlign()

Returns the button's menu alignment.

Returns:

the menu alignment

getMinWidth

public int getMinWidth()

Returns:

the minWidth

getMouseEvents

public boolean getMouseEvents()

Retutns true if mouse over effect is disabled.

Returns:

the handleMouseEvents the handle mouse event state

getText

public java.lang.String getText()

Returns the button's text.

Returns:

the button text

getType

public java.lang.String getType()

Returns:

the type

hideMenu

public void hideMenu()

Hide this button's menu (if it has one).

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

removeSelectionListener

public void removeSelectionListener(SelectionListener listener)

Removes a previously added listener.

Parameters:

listener - the listener to be removed

setIconStyle

public void setIconStyle(java.lang.String iconStyle)

Sets the button's icon style. The style name should match a CSS style that specifies a background image using the following format:

 
  .my-icon { background: url(images/icons/my-icon.png) no-repeat
 center left !important; } 
 
 

Parameters:

iconStyle - the icon style

setMenu

public void setMenu(Menu menu)

Sets the button's menu.

Parameters:

menu - the menu

setMenuAlign

public void setMenuAlign(java.lang.String menuAlign)

Sets the position to align the menu to, see El.alignTo(com.google.gwt.user.client.Element, java.lang.String, int[]) for more details (defaults to 'tl-bl?', pre-render).

Parameters:

menuAlign - the menu alignment

setMinWidth

public void setMinWidth(int minWidth)

Sets he minimum width for this button (used to give a set of buttons a common width)

Parameters:

minWidth - the minimum width

setMouseEvents

public void setMouseEvents(boolean handleMouseEvents)

False to disable visual cues on mouseover, mouseout and mousedown (defaults to true).

Parameters:

handleMouseEvents - false to disable mouse over cahnges

setTabIndex

public void setTabIndex(int index)

Sets the button's tab index.

Parameters:

index - the tab index

setText

public void setText(java.lang.String text)

Sets the button's text.

Parameters:

text - the new text

setType

public void setType(java.lang.String type)

Submit, reset or button (defaults to 'button').

Parameters:

type - the new type

showMenu

public void showMenu()

Show this button's menu (if it has one).