gwt.material.design.client.base

Class BaseCheckBox

java.lang.Object

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

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

com.google.gwt.user.client.ui.FocusWidget

com.google.gwt.user.client.ui.ButtonBase

gwt.material.design.client.base.BaseCheckBox

All Implemented Interfaces:

com.google.gwt.editor.client.IsEditor<com.google.gwt.editor.client.LeafValueEditor<Boolean>>, com.google.gwt.event.dom.client.HasAllDragAndDropHandlers, com.google.gwt.event.dom.client.HasAllFocusHandlers, com.google.gwt.event.dom.client.HasAllGestureHandlers, com.google.gwt.event.dom.client.HasAllKeyHandlers, com.google.gwt.event.dom.client.HasAllMouseHandlers, com.google.gwt.event.dom.client.HasAllTouchHandlers, com.google.gwt.event.dom.client.HasBlurHandlers, com.google.gwt.event.dom.client.HasClickHandlers, com.google.gwt.event.dom.client.HasDoubleClickHandlers, com.google.gwt.event.dom.client.HasDragEndHandlers, com.google.gwt.event.dom.client.HasDragEnterHandlers, com.google.gwt.event.dom.client.HasDragHandlers, com.google.gwt.event.dom.client.HasDragLeaveHandlers, com.google.gwt.event.dom.client.HasDragOverHandlers, com.google.gwt.event.dom.client.HasDragStartHandlers, com.google.gwt.event.dom.client.HasDropHandlers, com.google.gwt.event.dom.client.HasFocusHandlers, com.google.gwt.event.dom.client.HasGestureChangeHandlers, com.google.gwt.event.dom.client.HasGestureEndHandlers, com.google.gwt.event.dom.client.HasGestureStartHandlers, com.google.gwt.event.dom.client.HasKeyDownHandlers, com.google.gwt.event.dom.client.HasKeyPressHandlers, com.google.gwt.event.dom.client.HasKeyUpHandlers, com.google.gwt.event.dom.client.HasMouseDownHandlers, com.google.gwt.event.dom.client.HasMouseMoveHandlers, com.google.gwt.event.dom.client.HasMouseOutHandlers, com.google.gwt.event.dom.client.HasMouseOverHandlers, com.google.gwt.event.dom.client.HasMouseUpHandlers, com.google.gwt.event.dom.client.HasMouseWheelHandlers, com.google.gwt.event.dom.client.HasTouchCancelHandlers, com.google.gwt.event.dom.client.HasTouchEndHandlers, com.google.gwt.event.dom.client.HasTouchMoveHandlers, com.google.gwt.event.dom.client.HasTouchStartHandlers, com.google.gwt.event.logical.shared.HasAttachHandlers, com.google.gwt.event.logical.shared.HasValueChangeHandlers<Boolean>, com.google.gwt.event.shared.HasHandlers, com.google.gwt.i18n.shared.HasDirectionEstimator, com.google.gwt.safehtml.client.HasSafeHtml, com.google.gwt.user.client.EventListener, com.google.gwt.user.client.TakesValue<Boolean>, com.google.gwt.user.client.ui.Focusable, com.google.gwt.user.client.ui.HasDirectionalSafeHtml, com.google.gwt.user.client.ui.HasDirectionalText, com.google.gwt.user.client.ui.HasEnabled, com.google.gwt.user.client.ui.HasFocus, com.google.gwt.user.client.ui.HasHTML, com.google.gwt.user.client.ui.HasName, com.google.gwt.user.client.ui.HasText, com.google.gwt.user.client.ui.HasValue<Boolean>, com.google.gwt.user.client.ui.HasVisibility, com.google.gwt.user.client.ui.HasWordWrap, com.google.gwt.user.client.ui.IsWidget, com.google.gwt.user.client.ui.SourcesClickEvents, com.google.gwt.user.client.ui.SourcesFocusEvents, com.google.gwt.user.client.ui.SourcesKeyboardEvents, com.google.gwt.user.client.ui.SourcesMouseEvents

Direct Known Subclasses:

MaterialCheckBox

public class BaseCheckBox
extends com.google.gwt.user.client.ui.ButtonBase
implements com.google.gwt.user.client.ui.HasName, com.google.gwt.user.client.ui.HasValue<Boolean>, com.google.gwt.user.client.ui.HasWordWrap, com.google.gwt.user.client.ui.HasDirectionalSafeHtml, com.google.gwt.i18n.shared.HasDirectionEstimator, com.google.gwt.editor.client.IsEditor<com.google.gwt.editor.client.LeafValueEditor<Boolean>>

A standard check box widget.

This class also serves as a base class for RadioButton.

Built-in Bidi Text Support

This widget is capable of automatically adjusting its direction according to its content. This feature is controlled by setDirectionEstimator(boolean) or passing a DirectionEstimator parameter to the constructor, and is off by default.

CSS Style Rules

.gwt-CheckBox

the outer element

.gwt-CheckBox-disabled

applied when Checkbox is disabled

Example

{ @example com.google.gwt.examples.CheckBoxExample}

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

Modifier and Type	Field and Description
static com.google.gwt.i18n.shared.DirectionEstimator	DEFAULT_DIRECTION_ESTIMATOR

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

DEBUG_ID_PREFIX

Constructor Summary

Constructors

Modifier	Constructor and Description
	BaseCheckBox() Creates a check box with no label.
protected	BaseCheckBox(com.google.gwt.dom.client.Element elem)
	BaseCheckBox(com.google.gwt.safehtml.shared.SafeHtml label) Creates a check box with the specified text label.
	BaseCheckBox(com.google.gwt.safehtml.shared.SafeHtml label, com.google.gwt.i18n.shared.DirectionEstimator directionEstimator) Creates a check box with the specified text label.
	BaseCheckBox(com.google.gwt.safehtml.shared.SafeHtml label, com.google.gwt.i18n.client.HasDirection.Direction dir) Creates a check box with the specified text label.
	BaseCheckBox(String label) Creates a check box with the specified text label.
	BaseCheckBox(String label, boolean asHTML) Creates a check box with the specified text label.
	BaseCheckBox(String label, com.google.gwt.i18n.shared.DirectionEstimator directionEstimator) Creates a label with the specified text and a default direction estimator.
	BaseCheckBox(String label, com.google.gwt.i18n.client.HasDirection.Direction dir) Creates a check box with the specified text label.

Method Summary

Modifier and Type	Method and Description
com.google.gwt.event.shared.HandlerRegistration	addValueChangeHandler(com.google.gwt.event.logical.shared.ValueChangeHandler<Boolean> handler)
com.google.gwt.editor.client.LeafValueEditor<Boolean>	asEditor()
protected void	ensureDomEventHandlers()
com.google.gwt.i18n.shared.DirectionEstimator	getDirectionEstimator()
String	getFormValue() Returns the value property of the input element that backs this widget.
String	getHTML()
String	getName()
int	getTabIndex()
String	getText()
com.google.gwt.i18n.client.HasDirection.Direction	getTextDirection()
Boolean	getValue() Determines whether this check box is currently checked.
boolean	getWordWrap()
boolean	isChecked() Deprecated. Use getValue() instead
boolean	isEnabled()
protected void	onEnsureDebugId(String baseID) Affected Elements: -label = label next to checkbox.
protected void	onLoad() This method is called when a widget is attached to the browser's document.
protected void	onUnload() This method is called when a widget is detached from the browser's document.
void	setAccessKey(char key)
void	setDirectionEstimator(boolean enabled)
void	setDirectionEstimator(com.google.gwt.i18n.shared.DirectionEstimator directionEstimator)
void	setEnabled(boolean enabled)
void	setFocus(boolean focused)
void	setFormValue(String value) Set the value property on the input element that backs this widget.
void	setHTML(com.google.gwt.safehtml.shared.SafeHtml html, com.google.gwt.i18n.client.HasDirection.Direction dir)
void	setHTML(String html)
void	setName(String name)
void	setTabIndex(int index)
void	setText(String text)
void	setText(String text, com.google.gwt.i18n.client.HasDirection.Direction dir)
void	setValue(Boolean value) Checks or unchecks the check box.
void	setValue(Boolean value, boolean fireEvents) Checks or unchecks the check box, firing ValueChangeEvent if appropriate.
void	setWordWrap(boolean wrap)
void	sinkEvents(int eventBitsToAdd)

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

setHTML

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

addBlurHandler, addClickHandler, addClickListener, addDoubleClickHandler, addDragEndHandler, addDragEnterHandler, addDragHandler, addDragLeaveHandler, addDragOverHandler, addDragStartHandler, addDropHandler, addFocusHandler, addFocusListener, addGestureChangeHandler, addGestureEndHandler, addGestureStartHandler, addKeyboardListener, addKeyDownHandler, addKeyPressHandler, addKeyUpHandler, addMouseDownHandler, addMouseListener, addMouseMoveHandler, addMouseOutHandler, addMouseOverHandler, addMouseUpHandler, addMouseWheelHandler, addMouseWheelListener, addTouchCancelHandler, addTouchEndHandler, addTouchMoveHandler, addTouchStartHandler, getFocusImpl, onAttach, removeClickListener, removeFocusListener, removeKeyboardListener, removeMouseListener, removeMouseWheelListener

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, isAttached, isOrWasAttached, onBrowserEvent, onDetach, removeFromParent, setLayoutData, 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, removeStyleDependentName, removeStyleName, resolvePotentialElement, 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

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

fireEvent

Methods inherited from interface com.google.gwt.safehtml.client.HasSafeHtml

setHTML

Field Detail

DEFAULT_DIRECTION_ESTIMATOR

public static final com.google.gwt.i18n.shared.DirectionEstimator DEFAULT_DIRECTION_ESTIMATOR

Constructor Detail

BaseCheckBox

public BaseCheckBox()

Creates a check box with no label.

BaseCheckBox

public BaseCheckBox(com.google.gwt.safehtml.shared.SafeHtml label)

Creates a check box with the specified text label.

Parameters:

label - the check box's label

BaseCheckBox

public BaseCheckBox(com.google.gwt.safehtml.shared.SafeHtml label,
                    com.google.gwt.i18n.client.HasDirection.Direction dir)

Creates a check box with the specified text label.

Parameters:

label - the check box's label

dir - the text's direction. Note that DEFAULT means direction should be inherited from the widget's parent element.

BaseCheckBox

public BaseCheckBox(com.google.gwt.safehtml.shared.SafeHtml label,
                    com.google.gwt.i18n.shared.DirectionEstimator directionEstimator)

Creates a check box with the specified text label.

Parameters:

label - the check box's label

directionEstimator - A DirectionEstimator object used for automatic direction adjustment. For convenience, DEFAULT_DIRECTION_ESTIMATOR can be used.

BaseCheckBox

public BaseCheckBox(String label)

Creates a check box with the specified text label.

Parameters:

label - the check box's label

BaseCheckBox

public BaseCheckBox(String label,
                    com.google.gwt.i18n.client.HasDirection.Direction dir)

Creates a check box with the specified text label.

Parameters:

label - the check box's label

dir - the text's direction. Note that DEFAULT means direction should be inherited from the widget's parent element.

BaseCheckBox

public BaseCheckBox(String label,
                    com.google.gwt.i18n.shared.DirectionEstimator directionEstimator)

Creates a label with the specified text and a default direction estimator.

Parameters:

label - the check box's label

directionEstimator - A DirectionEstimator object used for automatic direction adjustment. For convenience, DEFAULT_DIRECTION_ESTIMATOR can be used.

BaseCheckBox

public BaseCheckBox(String label,
                    boolean asHTML)

Creates a check box with the specified text label.

Parameters:

label - the check box's label

asHTML - true to treat the specified label as html

BaseCheckBox

protected BaseCheckBox(com.google.gwt.dom.client.Element elem)

Method Detail

addValueChangeHandler

public com.google.gwt.event.shared.HandlerRegistration addValueChangeHandler(com.google.gwt.event.logical.shared.ValueChangeHandler<Boolean> handler)

Specified by:

addValueChangeHandler in interface com.google.gwt.event.logical.shared.HasValueChangeHandlers<Boolean>

asEditor

public com.google.gwt.editor.client.LeafValueEditor<Boolean> asEditor()

Specified by:

asEditor in interface com.google.gwt.editor.client.IsEditor<com.google.gwt.editor.client.LeafValueEditor<Boolean>>

getDirectionEstimator

public com.google.gwt.i18n.shared.DirectionEstimator getDirectionEstimator()

Specified by:

getDirectionEstimator in interface com.google.gwt.i18n.shared.HasDirectionEstimator

getFormValue

public String getFormValue()

Returns the value property of the input element that backs this widget. This is the value that will be associated with the CheckBox name and submitted to the server if a FormPanel that holds it is submitted and the box is checked.

Don't confuse this with getValue(), which returns true or false if the widget is checked.

getHTML

public String getHTML()

Specified by:

getHTML in interface com.google.gwt.user.client.ui.HasHTML

Overrides:

getHTML in class com.google.gwt.user.client.ui.ButtonBase

getName

public String getName()

Specified by:

getName in interface com.google.gwt.user.client.ui.HasName

getTabIndex

public int getTabIndex()

Specified by:

getTabIndex in interface com.google.gwt.user.client.ui.Focusable

Overrides:

getTabIndex in class com.google.gwt.user.client.ui.FocusWidget

getText

public String getText()

Specified by:

getText in interface com.google.gwt.user.client.ui.HasText

Overrides:

getText in class com.google.gwt.user.client.ui.ButtonBase

getTextDirection

public com.google.gwt.i18n.client.HasDirection.Direction getTextDirection()

Specified by:

getTextDirection in interface com.google.gwt.user.client.ui.HasDirectionalText

getValue

public Boolean getValue()

Determines whether this check box is currently checked.

Note that this does not return the value property of the checkbox input element wrapped by this widget. For access to that property, see getFormValue()

Specified by:

getValue in interface com.google.gwt.user.client.TakesValue<Boolean>

Specified by:

getValue in interface com.google.gwt.user.client.ui.HasValue<Boolean>

Returns:

true if the check box is checked, false otherwise. Will not return null

getWordWrap

public boolean getWordWrap()

Specified by:

getWordWrap in interface com.google.gwt.user.client.ui.HasWordWrap

isChecked

@Deprecated
public boolean isChecked()

Deprecated. Use getValue() instead

Determines whether this check box is currently checked.

Returns:

true if the check box is checked

isEnabled

public boolean isEnabled()

Specified by:

isEnabled in interface com.google.gwt.user.client.ui.HasEnabled

Overrides:

isEnabled in class com.google.gwt.user.client.ui.FocusWidget

setAccessKey

public void setAccessKey(char key)

Specified by:

setAccessKey in interface com.google.gwt.user.client.ui.Focusable

Overrides:

setAccessKey in class com.google.gwt.user.client.ui.FocusWidget

setDirectionEstimator

public void setDirectionEstimator(boolean enabled)

See note at setDirectionEstimator(DirectionEstimator).

Specified by:

setDirectionEstimator in interface com.google.gwt.i18n.shared.HasDirectionEstimator

setDirectionEstimator

public void setDirectionEstimator(com.google.gwt.i18n.shared.DirectionEstimator directionEstimator)

Note: DirectionEstimator should be set before the label has any content; it's highly recommended to set it using a constructor. Reason: if the label already has non-empty content, this will update its direction according to the new estimator's result. This may cause flicker, and thus should be avoided.

Specified by:

setDirectionEstimator in interface com.google.gwt.i18n.shared.HasDirectionEstimator

setEnabled

public void setEnabled(boolean enabled)

Specified by:

setEnabled in interface com.google.gwt.user.client.ui.HasEnabled

Overrides:

setEnabled in class com.google.gwt.user.client.ui.FocusWidget

setFocus

public void setFocus(boolean focused)

Specified by:

setFocus in interface com.google.gwt.user.client.ui.Focusable

Overrides:

setFocus in class com.google.gwt.user.client.ui.FocusWidget

setFormValue

public void setFormValue(String value)

Set the value property on the input element that backs this widget. This is the value that will be associated with the CheckBox's name and submitted to the server if a FormPanel that holds it is submitted and the box is checked.

Don't confuse this with setValue(java.lang.Boolean), which actually checks and unchecks the box.

Parameters:

value -

setHTML

public void setHTML(com.google.gwt.safehtml.shared.SafeHtml html,
                    com.google.gwt.i18n.client.HasDirection.Direction dir)

Specified by:

setHTML in interface com.google.gwt.user.client.ui.HasDirectionalSafeHtml

setHTML

public void setHTML(String html)

Specified by:

setHTML in interface com.google.gwt.user.client.ui.HasHTML

Overrides:

setHTML in class com.google.gwt.user.client.ui.ButtonBase

setName

public void setName(String name)

Specified by:

setName in interface com.google.gwt.user.client.ui.HasName

setTabIndex

public void setTabIndex(int index)

Specified by:

setTabIndex in interface com.google.gwt.user.client.ui.Focusable

Overrides:

setTabIndex in class com.google.gwt.user.client.ui.FocusWidget

setText

public void setText(String text)

Specified by:

setText in interface com.google.gwt.user.client.ui.HasText

Overrides:

setText in class com.google.gwt.user.client.ui.ButtonBase

setText

public void setText(String text,
                    com.google.gwt.i18n.client.HasDirection.Direction dir)

Specified by:

setText in interface com.google.gwt.user.client.ui.HasDirectionalText

setValue

public void setValue(Boolean value)

Checks or unchecks the check box.

Note that this does not set the value property of the checkbox input element wrapped by this widget. For access to that property, see setFormValue(String)

Specified by:

setValue in interface com.google.gwt.user.client.TakesValue<Boolean>

Specified by:

setValue in interface com.google.gwt.user.client.ui.HasValue<Boolean>

Parameters:

value - true to check, false to uncheck; null value implies false

setValue

public void setValue(Boolean value,
                     boolean fireEvents)

Checks or unchecks the check box, firing ValueChangeEvent if appropriate.

Note that this does not set the value property of the checkbox input element wrapped by this widget. For access to that property, see setFormValue(String)

Specified by:

setValue in interface com.google.gwt.user.client.ui.HasValue<Boolean>

Parameters:

value - true to check, false to uncheck; null value implies false

fireEvents - If true, and value has changed, fire a ValueChangeEvent

setWordWrap

public void setWordWrap(boolean wrap)

Specified by:

setWordWrap in interface com.google.gwt.user.client.ui.HasWordWrap

sinkEvents

public void sinkEvents(int eventBitsToAdd)

Overrides:

sinkEvents in class com.google.gwt.user.client.ui.Widget

ensureDomEventHandlers

protected void ensureDomEventHandlers()

onEnsureDebugId

protected void onEnsureDebugId(String baseID)

Affected Elements:

• -label = label next to checkbox.

Overrides:

onEnsureDebugId in class com.google.gwt.user.client.ui.UIObject

See Also:

UIObject.onEnsureDebugId(String)

onLoad

protected void onLoad()

This method is called when a widget is attached to the browser's document. onAttach needs special handling for the CheckBox case. Must still call Widget.onAttach() to preserve the onAttach contract.

Overrides:

onLoad in class com.google.gwt.user.client.ui.Widget

onUnload

protected void onUnload()

This method is called when a widget is detached from the browser's document. Overridden because of IE bug that throws away checked state and in order to clear the event listener off of the inputElem.

Overrides:

onUnload in class com.google.gwt.user.client.ui.Widget