ej.widget.basic

Class Button

java.lang.Object

ej.mwt.Widget

ej.widget.basic.Label

ej.widget.basic.Button

All Implemented Interfaces:

Clickable

public class Button
extends Label
implements Clickable

A button is a widget that displays a text and reacts to click events.

This example shows a simple button:

 Button button = new Button("Press Me");
 

This example shows a styled button:

 Button button = new Button("Press Me");

 CascadingStylesheet stylesheet = new CascadingStylesheet();
 desktop.setStylesheet(stylesheet);

 EditableStyle buttonStyle = stylesheet.getSelectorStyle(new TypeSelector(Button.class));
 buttonStyle.setBackground(new RectangularBackground(Colors.SILVER));
 buttonStyle.setBorder(new RectangularBorder(Colors.BLACK, 1));
 buttonStyle.setFont(Font.getFont("/fonts/source_sans_pro_24.ejf"));
 

This example shows a styled button with its background color changing on a press action:

 Button button = new Button("Press Me");

 CascadingStylesheet stylesheet = new CascadingStylesheet();
 desktop.setStylesheet(stylesheet);

 EditableStyle buttonStyle = stylesheet.getSelectorStyle(new TypeSelector(Button.class));
 buttonStyle.setBackground(new RectangularBackground(Colors.SILVER));
 buttonStyle.setBorder(new RectangularBorder(Colors.BLACK, 1));
 buttonStyle.setFont(Font.getFont("/fonts/source_sans_pro_24.ejf"));

 EditableStyle pressedButtonStyle = stylesheet
                .getSelectorStyle(new AndCombinator(new TypeSelector(Button.class), new StateSelector(States.ACTIVE)));
 pressedButtonStyle.setBackground(new RectangularBackground(Colors.GRAY));
 

Since:

2.3.0

Field Summary

Fields

Modifier and Type	Field and Description
static int	ACTIVE Active state.

Fields inherited from class ej.mwt.Widget

NO_CONSTRAINT

Constructor Summary

Constructors

Constructor and Description
Button() Creates a button with an empty text.
Button(String text) Creates a button with the given text to display.

Method Summary

Modifier and Type	Method and Description
boolean	handleEvent(int event) Handles the given event.
boolean	isInState(int state) Gets whether or not the widget is in the given state.
void	setOnClickListener(OnClickListener listener) Sets the listener on the click events of this button.
void	setPressed(boolean pressed) Changes the clickable element state.

Methods inherited from class ej.widget.basic.Label

computeContentOptimalSize, getText, renderContent, setText

Methods inherited from class ej.mwt.Widget

addClassSelector, contains, containsWidget, getAbsoluteX, getAbsoluteY, getContentBounds, getDesktop, getHeight, getParent, getStyle, getWidgetAt, getWidth, getX, getY, hasClassSelector, isAttached, isEnabled, isShown, isTransparent, onAttached, onDetached, onHidden, onLaidOut, onShown, removeAllClassSelectors, removeClassSelector, render, requestLayOut, requestRender, requestRender, setClassSelectors, setEnabled, setPosition, setStyle, updateStyle

Methods inherited from class java.lang.Object

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

Field Detail

ACTIVE

public static final int ACTIVE

Active state.

See Also:

Constant Field Values

Constructor Detail

Button

public Button()

Creates a button with an empty text.

Button

public Button(String text)

Creates a button with the given text to display.

Parameters:

text - the text to display.

Method Detail

handleEvent

public boolean handleEvent(int event)

Description copied from class: Widget

Handles the given event. Does nothing by default and returns false (does not consume event).

Called by the desktop event manager.

Overrides:

handleEvent in class Widget

Parameters:

event - the event to handle.

Returns:

true if the widget has consumed the event, false otherwise.

isInState

public boolean isInState(int state)

Description copied from class: Widget

Gets whether or not the widget is in the given state.

Overrides:

isInState in class Widget

Parameters:

state - the state to check.

Returns:

true if the widget is in the given state, false otherwise.

setOnClickListener

public void setOnClickListener(@Nullable
                               OnClickListener listener)

Sets the listener on the click events of this button.

Parameters:

listener - the listener to set.

setPressed

public void setPressed(boolean pressed)

Description copied from interface: Clickable

Changes the clickable element state.

Specified by:

setPressed in interface Clickable

Parameters:

pressed - true if the element is pressed, false otherwise.