totalcross.ui

Class MultiButton

java.lang.Object

totalcross.ui.gfx.GfxSurface

totalcross.ui.Control

totalcross.ui.MultiButton

public class MultiButton
extends Control

MultiButton is a control that displays a single line button with a set of titles. Can be used to replace a Check (with on/off) or a Radio (with their options). Sample:

 MultiButton b = new MultiButton(new String[]{"+","-"});
   b.setBackColor(Color.CYAN);
   add(b,LEFT+50,TOP+50,200,FONTSIZE+150);
 

Since:

TotalCross 2.0

Nested Class Summary

Nested classes/interfaces inherited from class totalcross.ui.Control

Control.TranslucentShape

Field Summary

Fields

Modifier and Type	Field and Description
int	divColor The color used to divide the texts.
boolean	is3dText Defines if the text will have a 3d style.
boolean	isSticky Set to true to behave like a Radio, false like a Button
int	selColor The selection color.

Fields inherited from class totalcross.ui.Control

AFTER, alphaValue, appId, appObj, asContainer, asWindow, backColor, BEFORE, BOTTOM, BOTTOM_OF, BRIGHTER_BACKGROUND, callListenersOnAllTargets, CENTER, CENTER_OF, clearValueInt, clearValueStr, DARKER_BACKGROUND, DP, effect, enableUpdateScreen, esce, eventsEnabled, FILL, fillColor, FIT, floating, fm, fmH, focusHandler, focusLess, focusOnPenDown, focusTraversable, font, FONTSIZE, foreColor, height, ignoreInsets, isHighlighting, isTablet, KEEP, keepDisabled, keepEnabled, LEFT, next, nextTabControl, npParts, offscreen, offscreen0, onEventFirst, parent, PARENTSIZE, PARENTSIZEMAX, PARENTSIZEMIN, PREFERRED, prev, RANGE, repositionAllowed, RIGHT, RIGHT_OF, SAME, SCREENSIZE, SCREENSIZEMAX, SCREENSIZEMIN, setFont, setH, setRel, setW, setX, SETX_NOT_SET, setY, tempW, textShadowColor, TOP, translucentShape, transparentBackground, uiAdjustmentsBasedOnFontHeightIsSupported, uiAndroid, UICONST, uiFlat, uiHolo, uiMaterial, uiVista, visible, width, WILL_RESIZE, x, y

Constructor Summary

Constructors

Constructor and Description
MultiButton(java.lang.String[] captions) Constructs a MultiButton with the given captions.

Method Summary

Modifier and Type	Method and Description
int	getEffectH()
int	getEffectW()
int	getEffectX()
int	getEffectY()
int	getPreferredHeight() Returns the preferred height of this control.
int	getPreferredWidth() Returns the preferred width of this control.
int	getSelectedIndex() Returns the selected index
boolean	isEnabled(int idx) Returns if a caption is enabled or not
void	onBoundsChanged(boolean colorsChanged) Called after a setRect.
void	onColorsChanged(boolean colorsChanged) Called after a setEnabled, setForeColor and setBackColor and when a control has been added to a Container.
void	onEvent(Event e) Called to process key, pen, control and other posted events.
void	onPaint(Graphics g) Called to draw the control.
void	setEnabled(int idx, boolean enabled) Enables or disables a caption
void	setSelectedIndex(int sel) Sets the selected index, or -1 to unset it.

Methods inherited from class totalcross.ui.Control

_onEvent, addEnabledStateListener, addFocusListener, addFontChangeHandler, addGridListener, addHandler, addHighlightListener, addKeyListener, addListContainerListener, addMouseListener, addMultiTouchListener, addPenListener, addPressListener, addPushNotificationListener, addSizeChangeHandler, addTimer, addTimer, addTimerListener, addValueChangeHandler, addWindowListener, bringToFront, changeHighlighted, clear, contains, drawTranslucentBackground, getAbsoluteRect, getBackColor, getDoEffect, getEventListeners, getFont, getForeColor, getGap, getGraphics, getHeight, getNext, getParent, getParentWindow, getPos, getPressedEvent, getPrev, getRect, getSize, getTextShadowColor, getWidth, getX, getX2, getY, getY2, hadParentScrolled, handleGeographicalFocusChangeKeys, hasFocus, internalSetEnabled, intXYWH, isActionEvent, isChildOf, isDisplayed, isEnabled, isFloating, isInsideOrNear, isObscured, isTopMost, isVisible, isVisibleAndInside, onFontChanged, onWindowPaintFinished, post, postEvent, postPressedEvent, releaseScreenShot, removeEnabledStateListener, removeFocusListener, removeGridListener, removeHandler, removeHighlightListener, removeKeyListener, removeListContainerListener, removeMouseListener, removeMultiTouchListener, removePenListener, removePressListener, removePushNotificationListener, removeTimer, removeTimerListener, removeWindowListener, repaint, repaintNow, reposition, reposition, repositionChildren, requestFocus, resetSetPositions, resetStyle, safeRepaintNow, safeUpdateScreen, sendToBack, setBackColor, setBackForeColors, setDoEffect, setEnabled, setFloating, setFocusLess, setFont, setForeColor, setNinePatch, setNinePatch, setRect, setRect, setRect, setRect, setSet, setTextShadowColor, setTranslucent, setVisible, showTip, takeInitialScreenShot, takeScreenShot, translateFromOrigin, uiStyleChanged, updateScreen, updateTemporary, willOpenKeyboard

Methods inherited from class java.lang.Object

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

Field Detail

divColor

public int divColor

The color used to divide the texts.

selColor

public int selColor

The selection color.

is3dText

public boolean is3dText

Defines if the text will have a 3d style.

isSticky

public boolean isSticky

Set to true to behave like a Radio, false like a Button

Constructor Detail

MultiButton

public MultiButton(java.lang.String[] captions)

Constructs a MultiButton with the given captions.

Method Detail

onColorsChanged

public void onColorsChanged(boolean colorsChanged)

Description copied from class: Control

Called after a setEnabled, setForeColor and setBackColor and when a control has been added to a Container. If colorsChanged is true, it was called from setForeColor/setBackColor/Container.add; otherwise, it was called from setEnabled

Overrides:

onColorsChanged in class Control

onBoundsChanged

public void onBoundsChanged(boolean colorsChanged)

Description copied from class: Control

Called after a setRect.

Overrides:

onBoundsChanged in class Control

Parameters:

colorsChanged - If the bounds were changed due to a screen change (rotation, collapse)

setSelectedIndex

public void setSelectedIndex(int sel)

Sets the selected index, or -1 to unset it. Only an enabled index can be selected.

setEnabled

public void setEnabled(int idx,
                       boolean enabled)

Enables or disables a caption

isEnabled

public boolean isEnabled(int idx)

Returns if a caption is enabled or not

getSelectedIndex

public int getSelectedIndex()

Returns the selected index

onPaint

public void onPaint(Graphics g)

Description copied from class: Control

Called to draw the control. When this method is called, the graphics object passed has been translated into the coordinate system of the control and the area behind the control has already been painted.

Overrides:

onPaint in class Control

Parameters:

g - the graphics object for drawing

See Also:

Graphics

getEffectW

public int getEffectW()

Overrides:

getEffectW in class Control

getEffectH

public int getEffectH()

Overrides:

getEffectH in class Control

getEffectX

public int getEffectX()

Overrides:

getEffectX in class Control

getEffectY

public int getEffectY()

Overrides:

getEffectY in class Control

onEvent

public void onEvent(Event e)

Description copied from class: Control

Called to process key, pen, control and other posted events.

Overrides:

onEvent in class Control

Parameters:

e - the event to process

See Also:

Event, KeyEvent, PenEvent

getPreferredHeight

public int getPreferredHeight()

Description copied from class: Control

Returns the preferred height of this control.

Overrides:

getPreferredHeight in class Control

getPreferredWidth

public int getPreferredWidth()

Description copied from class: Control

Returns the preferred width of this control.

Overrides:

getPreferredWidth in class Control