com.sencha.gxt.widget.core.client.form

Class CheckBox

java.lang.Object

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

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

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

com.sencha.gxt.widget.core.client.cell.CellComponent<T>

com.sencha.gxt.widget.core.client.form.Field<Boolean>

com.sencha.gxt.widget.core.client.form.CheckBox

All Implemented Interfaces:

Editor<Boolean>, HasEditorDelegate<Boolean>, HasEditorErrors<Boolean>, LeafValueEditor<Boolean>, ValueAwareEditor<Boolean>, HasChangeHandlers, HasAttachHandlers, HasResizeHandlers, HasValueChangeHandlers<Boolean>, HasHandlers, EventListener, TakesValue<Boolean>, HasEnabled, HasName, HasValue<Boolean>, HasVisibility, IsWidget, HasKeyProvider<Boolean>, BeforeHideEvent.HasBeforeHideHandlers, BeforeShowContextMenuEvent.HasBeforeShowContextMenuHandler, BeforeShowEvent.HasBeforeShowHandlers, BlurEvent.HasBlurHandlers, DisableEvent.HasDisableHandlers, EnableEvent.HasEnableHandlers, FocusEvent.HasFocusHandlers, HideEvent.HasHideHandlers, InvalidEvent.HasInvalidHandlers, MoveEvent.HasMoveHandlers, ShowContextMenuEvent.HasShowContextMenuHandler, ShowEvent.HasShowHandlers, ValidEvent.HasValidHandlers, HasErrorHandler, IsField<Boolean>, HasFocusSupport, HasItemId

Direct Known Subclasses:

Radio

public class CheckBox
extends Field<Boolean>
implements HasChangeHandlers

Simple checkbox field. ValueChangeEvents are fired when the checkbox state is changed by the user, instead of waiting for a BlurEvent.

Nested Class Summary

Nested classes/interfaces inherited from class com.sencha.gxt.widget.core.client.form.Field

Field.FieldStyles

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

UIObject.DebugIdImpl, UIObject.DebugIdImplEnabled

Field Summary

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

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Constructor and Description
CheckBox() Creates a new check box.
CheckBox(CheckBoxCell cell) Creates a new check box.

Method Summary

Methods

Modifier and Type	Method and Description
HandlerRegistration	addChangeHandler(ChangeHandler handler)
void	clear() Clears the value from the field.
void	clearInvalid() Clear any invalid styles / messages for this field.
String	getBoxLabel() Returns the box label.
CheckBoxCell	getCell() Get the Cell wrapped by this widget.
void	reset() Resets the current field value to the originally loaded value and clears any validation messages.
void	setBoxLabel(String boxLabel) The text that appears beside the checkbox (defaults to null).
void	setTabIndex(int tabIndex) Sets the component's tab index.
void	setValue(Boolean value)

Methods inherited from class com.sencha.gxt.widget.core.client.form.Field

addInvalidHandler, addValidator, addValidHandler, addValueChangeHandler, finishEditing, flush, forceInvalid, getErrors, getErrorSupport, getName, getOriginalValue, getValidateOnBlur, getValidationDelay, getValidators, isAutoValidate, isEditing, isValid, isValid, markInvalid, onBrowserEvent, onPropertyChange, removeValidator, setAutoValidate, setDelegate, setErrorSupport, setName, setOriginalValue, setReadOnly, setValidateOnBlur, setValidationDelay, setValue, showErrors, validate, validate

Methods inherited from class com.sencha.gxt.widget.core.client.cell.CellComponent

getElement, getKeyProvider, getValue, redraw, setValue

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

addBeforeHideHandler, addBeforeShowContextMenuHandler, addBeforeShowHandler, addBlurHandler, addDisableHandler, addEnableHandler, addFocusHandler, addHideHandler, addMoveHandler, addResizeHandler, addShowContextMenuHandler, addShowHandler, addStyleOnOver, clearSizeCache, disable, disableEvents, enable, enableEvents, fireEvent, focus, getData, getFocusSupport, getHideMode, getId, getItemId, getOffsetHeight, getOffsetWidth, getShadow, getShadowPosition, getStateId, getTabIndex, getToolTip, hide, hideToolTip, isAllowTextSelection, isAutoHeight, isAutoWidth, isDeferHeight, isEnabled, isRendered, isStateful, isVisible, isVisible, mask, mask, removeToolTip, setAllowTextSelection, setBorders, setBounds, setBounds, setContextMenu, setData, setDeferHeight, setEnabled, setHeight, setHeight, setHideMode, setId, setItemId, setPagePosition, setPixelSize, setPosition, setShadow, setShadowPosition, setSize, setStateful, setStateId, setToolTip, setToolTip, setToolTipConfig, setVisible, setWidth, setWidth, show, sync, syncSize, unmask

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

addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, getLayoutData, getParent, isAttached, removeFromParent, setLayoutData, sinkEvents, unsinkEvents

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

addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getOffsetHeight, getOffsetWidth, getStyleName, getStylePrimaryName, getTitle, isVisible, removeStyleDependentName, removeStyleName, setStyleDependentName, setStyleName, setStyleName, setStylePrimaryName, setTitle, setVisible, sinkBitlessEvent, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.gwt.event.shared.HasHandlers

fireEvent

Methods inherited from interface com.google.gwt.user.client.ui.IsWidget

asWidget

Methods inherited from interface com.google.gwt.user.client.TakesValue

getValue

Methods inherited from interface com.sencha.gxt.widget.core.client.event.BlurEvent.HasBlurHandlers

addBlurHandler

Methods inherited from interface com.google.gwt.user.client.ui.HasValue

getValue, setValue

Constructor Detail

CheckBox

public CheckBox()

Creates a new check box.

CheckBox

public CheckBox(CheckBoxCell cell)

Creates a new check box.

Parameters:

cell - the check box cell

Method Detail

addChangeHandler

public HandlerRegistration addChangeHandler(ChangeHandler handler)

Specified by:

addChangeHandler in interface HasChangeHandlers

clear

public void clear()

Clears the value from the field.

Specified by:

clear in interface IsField<Boolean>

Overrides:

clear in class Field<Boolean>

See Also:

to remove validation messages, to restore to original value and remove validation messages

clearInvalid

public void clearInvalid()

Description copied from class: Field

Clear any invalid styles / messages for this field.

Specified by:

clearInvalid in interface IsField<Boolean>

Overrides:

clearInvalid in class Field<Boolean>

getBoxLabel

public String getBoxLabel()

Returns the box label.

Returns:

the box label

getCell

public CheckBoxCell getCell()

Description copied from class: CellComponent

Get the Cell wrapped by this widget.

Overrides:

getCell in class Field<Boolean>

Returns:

the Cell being wrapped

setBoxLabel

public void setBoxLabel(String boxLabel)

The text that appears beside the checkbox (defaults to null).

Parameters:

boxLabel - the box label

setTabIndex

public void setTabIndex(int tabIndex)

Description copied from class: Component

Sets the component's tab index. Subclasses may override this to set the tab index on a specific element for better focus behavior - they are also responsible for setting the tabIndex field.

Overrides:

setTabIndex in class Component

Parameters:

tabIndex - the tab index

setValue

public void setValue(Boolean value)

Description copied from class: CellComponent

This method will redraw the widget if the new value does not equal the existing value.

Specified by:

setValue in interface ValueAwareEditor<Boolean>

Specified by:

setValue in interface TakesValue<Boolean>

Specified by:

setValue in interface HasValue<Boolean>

Overrides:

setValue in class CellComponent<Boolean>

reset

public void reset()

Description copied from interface: IsField

Resets the current field value to the originally loaded value and clears any validation messages.

Specified by:

reset in interface IsField<Boolean>

Overrides:

reset in class Field<Boolean>