net.xoetrope.awt
Class XRadioButton

java.lang.Object
  java.awt.Component
      java.awt.Checkbox
          net.xoetrope.awt.XRadioButton

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.ItemSelectable, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, XAttributedComponent, XRadioButtonGroup, XRadioHolder, XStateHolder, XTextHolder, XValueHolder

public class XRadioButton
extends java.awt.Checkbox
implements XStateHolder, XTextHolder, XValueHolder, XRadioHolder, XAttributedComponent, XRadioButtonGroup

A wrapper for the Checkbox class

Copyright (c) Xoetrope Ltd., 1998-2003
License: see license.txt

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Checkbox

java.awt.Checkbox.AccessibleAWTCheckbox

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

XRadioButton()
Constructs a blank radio button

Method Summary

void	associate(java.lang.Object cb) Adds the checkbox to the same group as this component.
java.lang.Object	createGroup() Create a new checkbox group and adds this radio button top the new group
java.lang.Object	getComponentState() Get the component state
java.lang.Object	getRadioButtonGroup() Gets the group controlling this radio button
java.lang.Object	getSelectedObject() Gets the selected radio button
java.lang.String	getText() Gets the text/caption
java.lang.Object	getValue() Get the radiobutton's value if it has one or else get the text
int	setAttribute(java.lang.String attribName, java.lang.Object attribValue) Set one or more attributes of the component.
void	setComponentState(java.lang.Object o) Set the component selection state: '1' or 'true' to select this option
void	setRadioButtonGroup(java.lang.Object grp) Set the button group
void	setSelected() Selects this radio button
void	setSelectedObject(java.lang.Object object) Select an item
void	setText(java.lang.String s) Sets the text of the button
void	setValue(java.lang.Object newValue) Set the value associated with this button
java.lang.String	toString() Return the text of the radio button.

Methods inherited from class java.awt.Checkbox

addItemListener, addNotify, getAccessibleContext, getCheckboxGroup, getItemListeners, getLabel, getListeners, getSelectedObjects, getState, paramString, processEvent, processItemEvent, removeItemListener, setCheckboxGroup, setLabel, setState

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

XRadioButton

public XRadioButton()

Constructs a blank radio button

Method Detail

setText

public void setText(java.lang.String s)

Sets the text of the button

Specified by:

setText in interface XTextHolder

Specified by:

setText in interface XValueHolder

Parameters:

s - the new caption

getText

public java.lang.String getText()

Gets the text/caption

Specified by:

getText in interface XTextHolder

Specified by:

getText in interface XValueHolder

Returns:

the text value

createGroup

public java.lang.Object createGroup()

Create a new checkbox group and adds this radio button top the new group

Specified by:

createGroup in interface XRadioButtonGroup

Returns:

the new group

setRadioButtonGroup

public void setRadioButtonGroup(java.lang.Object grp)

Set the button group

Specified by:

setRadioButtonGroup in interface XRadioButtonGroup

Parameters:

grp - the group control this radio button

getRadioButtonGroup

public java.lang.Object getRadioButtonGroup()

Gets the group controlling this radio button

Specified by:

getRadioButtonGroup in interface XRadioButtonGroup

Returns:

the ButtonGroup

getSelectedObject

public java.lang.Object getSelectedObject()

Gets the selected radio button

Specified by:

getSelectedObject in interface XRadioHolder

Returns:

the selected radio button

setSelectedObject

public void setSelectedObject(java.lang.Object object)

Select an item

Specified by:

setSelectedObject in interface XRadioHolder

Parameters:

object - the index of the item to select

setSelected

public void setSelected()

Selects this radio button

associate

public void associate(java.lang.Object cb)

Adds the checkbox to the same group as this component.

Parameters:

cb - the checkbox/radiobutton to be added to the group

setAttribute

public int setAttribute(java.lang.String attribName,
                        java.lang.Object attribValue)

Set one or more attributes of the component. Currently this handles the attributes

1. selected, value=true|false

Specified by:

setAttribute in interface XAttributedComponent

Parameters:

attribName - the attribute name

attribValue - the attribute value

Returns:

0 for success, non zero for failure or to require some further action

getComponentState

public java.lang.Object getComponentState()

Get the component state

Specified by:

getComponentState in interface XStateHolder

Returns:

the new component state

setComponentState

public void setComponentState(java.lang.Object o)

Set the component selection state: '1' or 'true' to select this option

Specified by:

setComponentState in interface XStateHolder

Parameters:

o - the object state'

getValue

public java.lang.Object getValue()

Get the radiobutton's value if it has one or else get the text

Specified by:

getValue in interface XValueHolder

Returns:

the value for this button

setValue

public void setValue(java.lang.Object newValue)

Set the value associated with this button

Specified by:

setValue in interface XValueHolder

Parameters:

newValue - the new button value

toString

public java.lang.String toString()

Return the text of the radio button. This is so that the model outputs the selected text and not the component details.

Overrides:

toString in class java.awt.Component

Returns:

the current value of this radio button