java.lang.Object | ||
↳ | javax.sound.sampled.Control | |
↳ | javax.sound.sampled.EnumControl |
A EnumControl
provides control over a set of
discrete possible values, each represented by an object. In a
graphical user interface, such a control might be represented
by a set of buttons, each of which chooses one value or setting. For
example, a reverb control might provide several preset reverberation
settings, instead of providing continuously adjustable parameters
of the sort that would be represented by
objects.
FloatControl
Controls that provide a choice between only two settings can often be implemented
instead as a
, and controls that provide
a set of values along some quantifiable dimension might be implemented
instead as a BooleanControl
FloatControl
with a coarse resolution.
However, a key feature of EnumControl
is that the returned values
are arbitrary objects, rather than numerical or boolean values. This means that each
returned object can provide further information. As an example, the settings
of a
control are instances of
REVERB
that can be queried for the parameter values
used for each setting.ReverbType
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
EnumControl.Type | An instance of the EnumControl.Type inner class identifies one kind of
enumerated control. |
Protected Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a new enumerated control object with the given parameters.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Obtains this control's current value.
| |||||||||||
Returns the set of possible values for this control.
| |||||||||||
Sets the current value for the control.
| |||||||||||
Provides a string representation of the control.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() | |||||||||||
![]() |
Constructs a new enumerated control object with the given parameters.
type | the type of control represented this enumerated control object |
---|---|
values | the set of possible values for the control |
value | the initial control value |
Returns the set of possible values for this control.
Sets the current value for the control. The default implementation simply sets the value as indicated. If the value indicated is not supported, an IllegalArgumentException is thrown. Some controls require that their line be open before they can be affected by setting a value.
value | the desired new value |
---|
IllegalArgumentException | if the value indicated does not fall within the allowable range |
---|
Provides a string representation of the control.