|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.havi.ui.HToggleGroup
public class HToggleGroup
HToggleButtons
within the same
HToggleGroup
will behave so that a
maximum of one HToggleButton
has
switchable state true, as returned by getSwitchableState
,
so as to achieve a "radio button" effect. When an HToggleButton
is acted upon to change
its switchable state to true, then if any other HToggleButton
within the HToggleGroup
currently has switchable
state true, it will have its switchable state set to
false. Similarly, if an HToggleButton
is added which has switchable state true, then any
current HToggleButton
within the
HToggleGroup
with switchable state
true, shall have its switchable state modified to false.
If the forced selection mode for the HToggleGroup
is set via a call to
setForcedSelection(true)
then there will always be one
HToggleButton
selected (i.e. with
switchable state true
), and if necessary the HToggleGroup
will automatically force a
selection to ensure this. If forced selection mode is not set it
is valid for there to be no selection, i.e. all HToggleButtons
may have switchable state
false
. By default forced selection mode is not set.
Note that when an HToggleButton
has switchable state true
this implies that the
interaction state as returned by getInteractionState
will
be either the ACTIONED_STATE
or
ACTIONED_FOCUSED_STATE
state.
Similarly, a switchable state of false
implies that
the interaction state is any other state for which the ACTIONED_STATE_BIT
is not
set. See the HSwitchable
class
description for more information about the valid interaction
states.
Parameter | Description | Default value | Set method | Get method |
---|---|---|---|---|
None. |
Description | Default value | Set method | Get method |
---|---|---|---|
Enable or disable buttons in group | enable |
setEnabled |
isEnabled |
Forced selection mode. | false |
setForcedSelection |
getForcedSelection |
Constructor Summary | |
---|---|
HToggleGroup()
Creates a new version instance of an HToggleGroup |
Method Summary | |
---|---|
HToggleButton |
getCurrent()
Returns the HToggleButton
from this HToggleGroup which
has state true, or null otherwise, for example, if there are no
HToggleButtons associated
with this HToggleGroup , or if
all HToggleButtons within
this HToggleGroup have state
false. |
boolean |
getForcedSelection()
Return the current forced selection mode of the group. |
boolean |
isEnabled()
Determines whether the HToggleGroup is enabled. |
void |
setCurrent(HToggleButton selection)
If the specified HToggleButton is a member of this HToggleGroup , then it is selected,
its state is set to true and consequently any other HToggleButtons within the HToggleGroup will have their states
set to false. |
void |
setEnabled(boolean enable)
Enables or disables the group, depending on the value of the parameter enable . |
void |
setForcedSelection(boolean forceSelection)
Set the forced selection mode of the group. |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public HToggleGroup()
HToggleGroup
Method Detail |
---|
public HToggleButton getCurrent()
HToggleButton
from this HToggleGroup
which
has state true, or null otherwise, for example, if there are no
HToggleButtons
associated
with this HToggleGroup
, or if
all HToggleButtons
within
this HToggleGroup
have state
false.
HToggleButton
or null if no such HToggleButton exists.public void setCurrent(HToggleButton selection)
HToggleButton
is a member of this HToggleGroup
, then it is selected,
its state is set to true and consequently any other HToggleButtons
within the HToggleGroup
will have their states
set to false.
If the specified HToggleButton
is not a member of this HToggleGroup
, then no actions are
performed.
selection
- the HToggleButton
to be set as the currently selected item within
the HToggleGroup
.public void setForcedSelection(boolean forceSelection)
forceSelection
is true and no HToggleButton
is currently selected
in the group the first HToggleButton
automatically has its switchable state set to
true. If no HToggleButton
components have been added to this group there will be no
visual indication of the mode change.
forceSelection
- if this parameter is true
the group is forced to always have one HToggleButton
selected (i.e. with
switchable state true
). Otherwise, the group may
have either one or zero HToggleButton(s)
selected.public boolean getForcedSelection()
true
the group is forced to always have one
HToggleButton selected (i.e. with switchable state
true
). Otherwise, the group may have either one or
zero HToggleButton(s)
selected.public void setEnabled(boolean enable)
enable
. An enabled group's HToggleButtons
can respond to user
input and generate events. An HToggleGroup
is initially enabled by default.
Enabling or disabling an HToggleGroup
enables or disables all the HToggleButton
components in the
group by calling their setEnabled
methods.
Whether or not a group is enabled does not affect the adding or
removing of HToggleButtons
from that group.
enable
- true
to enable all the HToggleButton
components in the
group, false
to disable them.isEnabled()
public boolean isEnabled()
HToggleGroup
is enabled. HToggleGroups
are enabled initially by default. A group
may be enabled or disabled by calling its
setEnabled
method.
true
if the component is enabled;
false
otherwise.setEnabled(boolean)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |