Class WPushButton
To act on a button click, connect a slot to the WInteractWidget.clicked()
signal.
WPushButton is an inline
widget.
CSS
The widget corresponds to the HTML <button>
tag (with some exceptions in
the bootstrap theme).
-
Nested Class Summary
Nested classes/interfaces inherited from class eu.webtoolkit.jwt.WObject
WObject.FormData
-
Field Summary
Fields inherited from class eu.webtoolkit.jwt.WInteractWidget
dragTouchEndSlot_, dragTouchSlot_
-
Constructor Summary
ConstructorDescriptionCreates a push button.WPushButton
(WContainerWidget parentContainer) Creates a push button.WPushButton
(CharSequence text) Creates a push button with given label text.WPushButton
(CharSequence text, TextFormat format) Creates a push button with given label text.WPushButton
(CharSequence text, TextFormat format, WContainerWidget parentContainer) Creates a push button with given label text.WPushButton
(CharSequence text, WContainerWidget parentContainer) Creates a push button with given label text. -
Method Summary
Modifier and TypeMethodDescriptionchecked()
Signal emitted when the button gets checked.protected void
Progresses to an Ajax-enabled widget.protected void
getDomChanges
(List<DomElement> result, WApplication app) Get DOM changes for this widget.getIcon()
Returns the icon.getLink()
Returns the destination link.getMenu()
Returns an associated popup menu.getText()
Returns the button text.Returns the text format.Returns the current value.boolean
Returns whether a button is checkable.boolean
Returns the button state.boolean
Returns whether the button is a default button.boolean
Set focus on the widget's first descendant.protected void
propagateSetEnabled
(boolean enabled) Propagates that a widget was enabled or disabled through children.void
refresh()
Refresh the widget.void
remove()
Destructor.void
setCheckable
(boolean checkable) Sets whether the button is checkable.void
Checks the button.void
setChecked
(boolean checked) Sets the button state.void
setDefault
(boolean enabled) Sets the default property.void
Sets an icon.void
Sets a destination link.void
setMenu
(WPopupMenu popupMenu) Links a popup menu to the button.boolean
setText
(CharSequence text) Sets the button text.boolean
setTextFormat
(TextFormat textFormat) Sets the text format.void
Unchecks the button.void
setValueText
(String value) Sets the current value.Signal emitted when the button gets unchecked.Methods inherited from class eu.webtoolkit.jwt.WFormWidget
changed, getLabel, getPlaceholderText, getTabIndex, getValidator, isCanReceiveFocus, isReadOnly, render, setEnabled, setHidden, setPlaceholderText, setReadOnly, setToolTip, setValidator, validate, validated, validatorChanged
Methods inherited from class eu.webtoolkit.jwt.WInteractWidget
clicked, doubleClicked, enterPressed, escapePressed, gestureChanged, gestureEnded, gestureStarted, getMouseOverDelay, isEnabled, keyPressed, keyWentDown, keyWentUp, load, mouseDragged, mouseMoved, mouseWentDown, mouseWentOut, mouseWentOver, mouseWentUp, mouseWheel, setDraggable, setDraggable, setDraggable, setDraggable, setMouseOverDelay, setPopup, touchEnded, touchMoved, touchStarted, unsetDraggable
Methods inherited from class eu.webtoolkit.jwt.WWebWidget
addStyleClass, beingDeleted, blurred, callJavaScriptMember, childrenChanged, createDomElement, doJavaScript, escapeText, escapeText, escapeText, escapeText, find, findById, focussed, getAttributeValue, getBaseZIndex, getChildren, getClearSides, getDecorationStyle, getFloatSide, getHeight, getHtmlTagName, getId, getJavaScriptMember, getLineHeight, getMargin, getMaximumHeight, getMaximumWidth, getMinimumHeight, getMinimumWidth, getOffset, getPositionScheme, getScrollVisibilityMargin, getStyleClass, getToolTip, getVerticalAlignment, getVerticalAlignmentLength, getWidth, hasFocus, hasStyleClass, isDisabled, isHidden, isHiddenKeepsGeometry, isInline, isLoaded, isPopup, isRendered, isScrollVisibilityEnabled, isScrollVisible, isThemeStyleEnabled, isVisible, iterateChildren, jsStringLiteral, jsStringLiteral, manageWidget, parentResized, parentResized, propagateSetVisible, removeScript, removeStyleClass, resize, scrollVisibilityChanged, setAttributeValue, setBaseZIndex, setCanReceiveFocus, setClearSides, setDecorationStyle, setDeferredToolTip, setDisabled, setFlexBox, setFloatSide, setFocus, setHiddenKeepsGeometry, setHtmlTagName, setId, setInline, setJavaScriptMember, setLineHeight, setLoadLaterWhenInvisible, setMargin, setMaximumSize, setMinimumSize, setObjectName, setOffsets, setParentWidget, setPositionScheme, setScrollVisibilityEnabled, setScrollVisibilityMargin, setSelectable, setStyleClass, setTabIndex, setThemeStyleEnabled, setVerticalAlignment, unescapeText, updateSignalConnection, voidEventSignal, widgetAdded, widgetRemoved
Methods inherited from class eu.webtoolkit.jwt.WWidget
acceptDrops, acceptDrops, addCssRule, addCssRule, addJSignal, addStyleClass, animateHide, animateShow, boxBorder, boxPadding, createJavaScript, disable, dropEvent, enable, getDropTouch, getJsRef, getParent, hide, htmlText, isExposed, isGlobalWidget, isLayoutSizeAware, layoutSizeChanged, needsRerender, positionAt, positionAt, removeFromParent, removeStyleClass, removeWidget, render, resize, scheduleRender, scheduleRender, scheduleRender, setClearSides, setDeferredToolTip, setFocus, setHeight, setHidden, setLayoutSizeAware, setMargin, setMargin, setMargin, setMargin, setMargin, setOffsets, setOffsets, setOffsets, setOffsets, setOffsets, setToolTip, setVerticalAlignment, setWidth, show, stopAcceptDrops, toggleStyleClass, toggleStyleClass, tr
Methods inherited from class eu.webtoolkit.jwt.WObject
getObjectName, setFormData
-
Constructor Details
-
WPushButton
Creates a push button. -
WPushButton
public WPushButton()Creates a push button. -
WPushButton
Creates a push button with given label text.The default text format is
TextFormat.Plain
. -
WPushButton
Creates a push button with given label text. -
WPushButton
Creates a push button with given label text. -
WPushButton
Creates a push button with given label text.
-
-
Method Details
-
remove
public void remove()Description copied from class:WFormWidget
Destructor.- Overrides:
remove
in classWFormWidget
- See Also:
-
setDefault
public void setDefault(boolean enabled) Sets the default property.This has only a functional meaning for a button in a dialog footer, as it becomes associated with pressing 'enter' in the dialog.
A default button may be rendered in a different style, depending on the theme.
-
isDefault
public boolean isDefault()Returns whether the button is a default button.- See Also:
-
setCheckable
public void setCheckable(boolean checkable) Sets whether the button is checkable.A checkable button can be checked and unchecked, and clicking will toggle between these two states.
- See Also:
-
isCheckable
public boolean isCheckable()Returns whether a button is checkable.- See Also:
-
setChecked
public void setChecked(boolean checked) Sets the button state.This is ignored for a button which is not checkable.
This method does not emit one of the
checked()
orunChecked()
signals. -
setChecked
public void setChecked()Checks the button.Does not emit the
checked()
signal.- See Also:
-
setUnChecked
public void setUnChecked()Unchecks the button.Does not emit the
unChecked()
signal.- See Also:
-
isChecked
public boolean isChecked()Returns the button state.- See Also:
-
setText
Sets the button text.The default text format is
TextFormat.Plain
.When the current text format is
TextFormat.XHTML
, andtext
is literal (not created usingWString#tr()
), it is parsed using an XML parser which discards malicious tags and attributes silently. When the parser encounters an XML parse error, the textFormat is changed toTextFormat.Plain
. Iftext
is not a literal, the same parser is applied only when the text is resolved.Returns whether the text could be set using the current textFormat. A return value of
false
indicates that the text format was changed in order to be able to accept the new text.- See Also:
-
getText
Returns the button text.- See Also:
-
setTextFormat
Sets the text format.The textFormat controls how the string should be interpreted: either as plain text, which is displayed literally, or as XHTML-markup.
When changing the textFormat to
TextFormat.XHTML
, and the current text is literal (not created usingWString#tr()
), the current text is parsed using an XML parser which discards malicious tags and attributes silently. When the parser encounters an XML parse error, the textFormat is left unchanged, and this method returns false.Returns whether the textFormat could be set for the current text.
The default format is
TextFormat.Plain
. -
getTextFormat
Returns the text format.- See Also:
-
setIcon
Sets an icon.The icon is placed to the left of the text.
-
getIcon
Returns the icon.- See Also:
-
setLink
Sets a destination link.This method can be used to make the button behave like a
WAnchor
(or conversely, an anchor look like a button) and redirect to another URL when clicked.The
link
may be to a URL, a resource, or an internal path.By default, a button does not link to an URL and you should listen to the
WInteractWidget.clicked()
signal to react to a click event.Warning: In Bootstrap theme, you should set a link before it's rendered since it commit's the button to be rendered as an anchor. (see also http://redmine.emweb.be/issues/1802).
-
getLink
Returns the destination link.- See Also:
-
getValueText
Returns the current value.Returns an empty string, since a button has no value.
- Specified by:
getValueText
in classWFormWidget
-
setValueText
Sets the current value.Has no effect, since a button has not value.
- Specified by:
setValueText
in classWFormWidget
-
setMenu
Links a popup menu to the button.When the button is clicked, the linked popup menu is shown.
-
getMenu
Returns an associated popup menu.- See Also:
-
refresh
public void refresh()Description copied from class:WWidget
Refresh the widget.The refresh method is invoked when the locale is changed using
WApplication#setLocale()
or when the user hit the refresh button.The widget must actualize its contents in response.
Note: This does not rerender the widget! Calling
refresh()
usually does not have any effect (unless you've reimplementedrefresh()
to attach to it an effect).- Overrides:
refresh
in classWFormWidget
-
checked
Signal emitted when the button gets checked.This signal is emitted when the user checks the button.
You can use the
WInteractWidget.clicked()
signal to react to any change of the button state.- See Also:
-
unChecked
Signal emitted when the button gets unchecked.This signal is emitted when the user unchecks the button.
You can use the
WInteractWidget.clicked()
signal to react to any change of the button state.- See Also:
-
isSetFirstFocus
public boolean isSetFirstFocus()Description copied from class:WWidget
Set focus on the widget's first descendant.Set focus on the widget itself, or on a first descendant which can receive focus.
Returns whether focus could be set.
- Overrides:
isSetFirstFocus
in classWWebWidget
-
getDomChanges
Description copied from class:WWebWidget
Get DOM changes for this widget.This is an internal function, and should not be called directly, or be overridden!
- Overrides:
getDomChanges
in classWWebWidget
-
propagateSetEnabled
protected void propagateSetEnabled(boolean enabled) Description copied from class:WWidget
Propagates that a widget was enabled or disabled through children.When enabling or disabling a widget, you usually also want to disable contained children. This method is called by
setDisabled()
to propagate its state to all children.You may want to reimplement this method if they wish to render differently when a widget is disabled. The default implementation will propagate the signal to all children.
- Overrides:
propagateSetEnabled
in classWFormWidget
-
enableAjax
protected void enableAjax()Description copied from class:WWidget
Progresses to an Ajax-enabled widget.This method is called when the progressive bootstrap method is used, and support for AJAX has been detected. The default behavior will upgrade the widget's event handling to use AJAX instead of full page reloads, and propagate the call to its children.
You may want to reimplement this method if you want to make changes to widget when AJAX is enabled. You should always call the base implementation.
- Overrides:
enableAjax
in classWFormWidget
- See Also:
-