de.must.markup

Class RadioButtonGroup

java.lang.Object

de.must.markup.MustInputField

de.must.markup.RadioButtonGroup

All Implemented Interfaces:

Markupable, ValueFetcher

Direct Known Subclasses:

DataTextCheck

public class RadioButtonGroup
extends MustInputField

A component to present a group of radio buttons.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	additionalTagFragments
protected java.lang.String	className
protected int	editBeginIndex

Fields inherited from class de.must.markup.MustInputField

comment, focus, name, placeholder, toolTipText

Constructor Summary

Constructors

Constructor and Description
RadioButtonGroup(java.lang.String[] checkLabels)
RadioButtonGroup(java.lang.String[] checkLabels, java.lang.String[] values)
RadioButtonGroup(java.lang.String[] checkLabels, java.lang.String[] values, java.lang.String[] links)
RadioButtonGroup(java.lang.String name, java.lang.String[] checkLabels, java.lang.String[] values)
RadioButtonGroup(java.lang.String name, java.lang.String[] checkLabels, java.lang.String[] values, java.lang.String[] links)

Method Summary

Modifier and Type	Method and Description
void	destroy() Destroys the markupable.
void	fetchYourValueFromRequest(GeneralizedRequest request) Causes the component to read user input by calling request.getParameter and update the internal mirrored value.
java.lang.String	getCreationTag() Returns the tag sequence that's needed to show this object in the user interface.
int	getSelectedIndex() Returns the index of the currently selected item.
java.lang.String	getSelectedKey() Returns the key of the currently selected item.
boolean	isModified() Indicates whether the component's value differs from its initial value.
void	selectFirstEnabledItem() Selects the first of all enabled items.
void	setAdditionalTagFragments(java.lang.String additionalTagFragments) Sets the component's additional tag fragments.
void	setClassName(java.lang.String className) Sets the component's class name - may be used to assign formatting via stylesheets.
static void	setDefaultAdditionalTagFragments(java.lang.String newDefaultAdditionalTagFragments) Sets the component's default additional tag fragments.
static void	setDefaultClassName(java.lang.String newDefaultClassName) Sets the component's default class name - may be used to assign formatting via stylesheets.
void	setEnabled(boolean enabled) Enables or disables all items.
void	setEnabled(int anIndex, boolean enabled) Enables or disables an item by index.
void	setLinks(java.lang.String[] links) Changes the links of the radio buttons, e.g. with encoded stuff like jsessionid.
void	setSelectedIndex(int anIndex) Selects the item at index.
void	setSelectedKey(java.lang.String key) Selects the item by its key.

Methods inherited from class de.must.markup.MustInputField

getName, setComment, setFocus, setPlaceHolder, setToolTipText, toString

Methods inherited from class java.lang.Object

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

Field Detail

className

protected java.lang.String className

additionalTagFragments

protected java.lang.String additionalTagFragments

editBeginIndex

protected int editBeginIndex

Constructor Detail

RadioButtonGroup

public RadioButtonGroup(java.lang.String[] checkLabels)

RadioButtonGroup

public RadioButtonGroup(java.lang.String[] checkLabels,
                        java.lang.String[] values)

RadioButtonGroup

public RadioButtonGroup(java.lang.String[] checkLabels,
                        java.lang.String[] values,
                        java.lang.String[] links)

RadioButtonGroup

public RadioButtonGroup(java.lang.String name,
                        java.lang.String[] checkLabels,
                        java.lang.String[] values)

RadioButtonGroup

public RadioButtonGroup(java.lang.String name,
                        java.lang.String[] checkLabels,
                        java.lang.String[] values,
                        java.lang.String[] links)

Method Detail

setLinks

public void setLinks(java.lang.String[] links)

Changes the links of the radio buttons, e.g. with encoded stuff like jsessionid.

Parameters:

links - the new links to use

setDefaultClassName

public static void setDefaultClassName(java.lang.String newDefaultClassName)

Sets the component's default class name - may be used to assign formatting via stylesheets.

Parameters:

newDefaultClassName - the component's default class name

setClassName

public void setClassName(java.lang.String className)

Sets the component's class name - may be used to assign formatting via stylesheets.

Parameters:

newDefaultClassName - the component's class name

setDefaultAdditionalTagFragments

public static void setDefaultAdditionalTagFragments(java.lang.String newDefaultAdditionalTagFragments)

Sets the component's default additional tag fragments. E.g. JavaScript like onChange may be added.

Parameters:

newDefaultClassName - the component's default additional tag fragments.

setAdditionalTagFragments

public void setAdditionalTagFragments(java.lang.String additionalTagFragments)

Sets the component's additional tag fragments. E.g. JavaScript like onChange may be added.

Parameters:

newDefaultClassName - the component's additional tag fragments.

setEnabled

public void setEnabled(boolean enabled)

Enables or disables all items.

Parameters:

enabled - whether the items should be enabeld or not

setEnabled

public void setEnabled(int anIndex,
                       boolean enabled)

Enables or disables an item by index.

Parameters:

anIndex - an int specifying the item to select, where 0 specifies

enabled - whether the item should be enabeld or not

selectFirstEnabledItem

public void selectFirstEnabledItem()

Selects the first of all enabled items.

setSelectedKey

public void setSelectedKey(java.lang.String key)

Selects the item by its key.

Parameters:

key - the key of the item to select

setSelectedIndex

public void setSelectedIndex(int anIndex)

Selects the item at index.

Parameters:

anIndex - an int specifying the item to select, where 0 specifies the first item

getSelectedIndex

public int getSelectedIndex()

Returns the index of the currently selected item. Returns -1 if there is no selected item.

Returns:

the index of the currently selected item

getSelectedKey

public java.lang.String getSelectedKey()

Returns the key of the currently selected item. Returns null if there is no selected item.

Returns:

the index of the currently selected item

getCreationTag

public java.lang.String getCreationTag()

Returns the tag sequence that's needed to show this object in the user interface.

Returns:

the tag sequence to show the component

fetchYourValueFromRequest

public void fetchYourValueFromRequest(GeneralizedRequest request)

Causes the component to read user input by calling request.getParameter and update the internal mirrored value.

Specified by:

fetchYourValueFromRequest in interface ValueFetcher

Specified by:

fetchYourValueFromRequest in class MustInputField

Parameters:

request - the current request

isModified

public boolean isModified()

Indicates whether the component's value differs from its initial value.

Returns:

true if the component's value differs from its initial value

destroy

public void destroy()

Description copied from interface: Markupable

Destroys the markupable. Useful to release e.g. static references which prevent the garbage collector from finalizing. For example HalfDataComboBoxes add s as Listeners to database changes. These listeners are registered statically. Thus, these listeners cannot be removed by the garbage collector, they have to be removed manually. This may be done by calling this destroy method.

Specified by:

destroy in interface Markupable

Overrides:

destroy in class MustInputField

See Also:

Markupable.destroy()