com.sencha.gxt.widget.core.client.menu

Class CheckMenuItem

java.lang.Object

Widget

com.sencha.gxt.widget.core.client.Component

com.sencha.gxt.widget.core.client.menu.Item

com.sencha.gxt.widget.core.client.menu.MenuItem

com.sencha.gxt.widget.core.client.menu.CheckMenuItem

All Implemented Interfaces:

HasGestureRecognizers, ActivateEvent.HasActivateHandlers<Item>, BeforeCheckChangeEvent.HasBeforeCheckChangeHandlers<CheckMenuItem>, BeforeHideEvent.HasBeforeHideHandlers, BeforeShowContextMenuEvent.HasBeforeShowContextMenuHandler, BeforeShowEvent.HasBeforeShowHandlers, BlurEvent.HasBlurHandlers, CheckChangeEvent.HasCheckChangeHandlers<CheckMenuItem>, DeactivateEvent.HasDeactivateHandlers<Item>, DisableEvent.HasDisableHandlers, EnableEvent.HasEnableHandlers, FocusEvent.HasFocusHandlers, HideEvent.HasHideHandlers, MoveEvent.HasMoveHandlers, ShowContextMenuEvent.HasShowContextMenuHandler, ShowEvent.HasShowHandlers, HasFocusSupport, HasIcon, HasItemId

public class CheckMenuItem
extends MenuItem
implements BeforeCheckChangeEvent.HasBeforeCheckChangeHandlers<CheckMenuItem>, CheckChangeEvent.HasCheckChangeHandlers<CheckMenuItem>

Adds a menu item that contains a checkbox by default, but can also be part of a radio group.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	CheckMenuItem.CheckMenuItemAppearance

Nested classes/interfaces inherited from class com.sencha.gxt.widget.core.client.menu.MenuItem

MenuItem.MenuItemAppearance

Nested classes/interfaces inherited from class com.sencha.gxt.widget.core.client.menu.Item

Item.ItemAppearance

Field Summary

Fields inherited from class com.sencha.gxt.widget.core.client.menu.MenuItem

html, icon, subMenu, widget

Fields inherited from class com.sencha.gxt.widget.core.client.menu.Item

canActivate, hideOnClick

Fields inherited from class com.sencha.gxt.widget.core.client.Component

adjustSize, allowTextSelection, cacheSizes, disableContextMenu, disabled, disabledStyle, ensureVisibilityOnSizing, height, hidden, lastSize, layer, left, mask, maskMessage, monitorWindowResize, pageX, pageY, resizeHandler, shim, tabIndex, toolTip, toolTipConfig, top, width, windowResizeDelay, windowResizeTask

Constructor Summary

Constructors

Constructor and Description
CheckMenuItem() Creates a new check menu item.
CheckMenuItem(CheckMenuItem.CheckMenuItemAppearance appearance)
CheckMenuItem(String text) Creates a new check menu item.

Method Summary

Modifier and Type	Method and Description
HandlerRegistration	addBeforeCheckChangeHandler(BeforeCheckChangeEvent.BeforeCheckChangeHandler<CheckMenuItem> handler) Adds a BeforeCheckChangeEvent.BeforeCheckChangeHandler handler for BeforeCheckChangeEvent events.
HandlerRegistration	addCheckChangeHandler(CheckChangeEvent.CheckChangeHandler<CheckMenuItem> handler) Adds a CheckChangeEvent.CheckChangeHandler handler for CheckChangeEvent events.
String	getAriaGroupTitle() Returns the ARIA group title.
CheckMenuItem.CheckMenuItemAppearance	getCheckMenuItemAppearance()
String	getGroup() Returns the group name.
boolean	isChecked() Returns true if the item is checked.
protected void	onClick(NativeEvent ce)
void	setAriaGroupTitle(String title) Sets the title attribute on the group container element.
void	setChecked(boolean checked) Set the checked state of this item.
void	setChecked(boolean state, boolean suppressEvent) Set the checked state of this item.
void	setGroup(String group) All check items with the same group name will automatically be grouped into a single-select radio button group (defaults to null).
protected void	toggleRadios()

Methods inherited from class com.sencha.gxt.widget.core.client.menu.MenuItem

activate, deactivate, doAttachChildren, doDetachChildren, expandMenu, expandMenu, getAppearance, getHTML, getIcon, getSafeHtml, getSubMenu, getText, handleClick, hasSubMenu, setHTML, setIcon, setSubMenu, setText, setWidget, shouldDeactivate

Methods inherited from class com.sencha.gxt.widget.core.client.menu.Item

addActivateHandler, addBeforeSelectionHandler, addDeactivateHandler, addSelectionHandler, getHideOnClick, isCanActivate, isHideOnClick, onAttach, onDisable, onEnable, onEscape, setCanActivate, setHideOnClick

Methods inherited from class com.sencha.gxt.widget.core.client.Component

addBeforeHideHandler, addBeforeShowContextMenuHandler, addBeforeShowHandler, addBlurHandler, addDisableHandler, addEnableHandler, addFocusHandler, addGestureRecognizer, addHideHandler, addMoveHandler, addResizeHandler, addShowContextMenuHandler, addShowHandler, addStyleDependentName, addStyleOnOver, adjustPosition, adjustSize, applyState, assertAfterRender, assertPreRender, blur, clearSizeCache, disable, disableContextMenu, disableEvents, enable, enableEvents, fireCancellableEvent, fireEvent, focus, getData, getElement, getFocusEl, getFocusSupport, getGestureRecognizer, getGestureRecognizerCount, getHideMode, getId, getItemId, getOffsetHeight, getOffsetWidth, getPositionEl, getShadow, getShadowPosition, getStateId, getTabIndex, getToolTip, hide, hideShadow, hideToolTip, isAllowTextSelection, isAutoHeight, isAutoWidth, isDeferHeight, isEnabled, isMonitorWindowResize, isRendered, isStateful, isVisible, isVisible, mask, mask, notifyHide, notifyShow, onAfterFirstAttach, onBlur, onBrowserEvent, onDetach, onFocus, onHide, onHideContextMenu, onLoad, onPosition, onResize, onRightClick, onShow, onShowContextMenu, onTouch, onUnload, onWindowResize, removeStyleDependentName, removeStyleOnOver, removeToolTip, setAllowTextSelection, setBorders, setBounds, setBounds, setContextMenu, setData, setDeferHeight, setEnabled, setHeight, setHeight, setHideMode, setId, setItemId, setMonitorWindowResize, setPagePosition, setPixelSize, setPosition, setShadow, setShadowPosition, setSize, setStateful, setStateId, setStyleDependentName, setTabIndex, setToolTip, setToolTipConfig, setVisible, setWidth, setWidth, show, sync, syncSize, unmask

Methods inherited from class java.lang.Object

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

Constructor Detail

CheckMenuItem

public CheckMenuItem()

Creates a new check menu item.

CheckMenuItem

public CheckMenuItem(CheckMenuItem.CheckMenuItemAppearance appearance)

CheckMenuItem

public CheckMenuItem(String text)

Creates a new check menu item.

Parameters:

text - the text

Method Detail

addBeforeCheckChangeHandler

public HandlerRegistration addBeforeCheckChangeHandler(BeforeCheckChangeEvent.BeforeCheckChangeHandler<CheckMenuItem> handler)

Description copied from interface: BeforeCheckChangeEvent.HasBeforeCheckChangeHandlers

Adds a BeforeCheckChangeEvent.BeforeCheckChangeHandler handler for BeforeCheckChangeEvent events.

Specified by:

addBeforeCheckChangeHandler in interface BeforeCheckChangeEvent.HasBeforeCheckChangeHandlers<CheckMenuItem>

Parameters:

handler - the handler

Returns:

the registration for the event

addCheckChangeHandler

public HandlerRegistration addCheckChangeHandler(CheckChangeEvent.CheckChangeHandler<CheckMenuItem> handler)

Description copied from interface: CheckChangeEvent.HasCheckChangeHandlers

Adds a CheckChangeEvent.CheckChangeHandler handler for CheckChangeEvent events.

Specified by:

addCheckChangeHandler in interface CheckChangeEvent.HasCheckChangeHandlers<CheckMenuItem>

Parameters:

handler - the handler

Returns:

the registration for the event

getCheckMenuItemAppearance

public CheckMenuItem.CheckMenuItemAppearance getCheckMenuItemAppearance()

getAriaGroupTitle

public String getAriaGroupTitle()

Returns the ARIA group title.

Returns:

the group title

getGroup

public String getGroup()

Returns the group name.

Returns:

the name

isChecked

public boolean isChecked()

Returns true if the item is checked.

Returns:

the checked state

setAriaGroupTitle

public void setAriaGroupTitle(String title)

Sets the title attribute on the group container element. Only applies to radio check items when ARIA is enabled.

Parameters:

title - the title

setChecked

public void setChecked(boolean checked)

Set the checked state of this item. If the item is in a group of CheckMenuItems, then it will toggle them as radios.

Parameters:

checked - the new checked state

setChecked

public void setChecked(boolean state,
                       boolean suppressEvent)

Set the checked state of this item.

Parameters:

state - the new checked state

suppressEvent - true to prevent the CheckChange event from firing

setGroup

public void setGroup(String group)

All check items with the same group name will automatically be grouped into a single-select radio button group (defaults to null).

Parameters:

group - the group

onClick

protected void onClick(NativeEvent ce)

Overrides:

onClick in class Item

toggleRadios

protected void toggleRadios()