|
MID Profile | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Controllable
provides an interface for
obtaining the Control
s from an object
like a Player
.
It provides methods to query all the supported Control
s
and to obtain a particular Control
based on its class
name.
Method Summary | |
Control |
getControl(String controlType)
Obtain the object that implements the specified Control interface. |
Control[] |
getControls()
Obtain the collection of Control s
from the object that implements this interface. |
Method Detail |
public Control[] getControls()
Control
s
from the object that implements this interface.
Since a single object can implement multiple
Control
interfaces, it's necessary
to check each object against different Control
types. For example:
Controllable controllable;
:
Control cs[];
cs = controllable.getControls();
for (int i = 0; i < cs.length; i++) {
if (cs[i] instanceof ControlTypeA)
doSomethingA();
if (cs[i] instanceof ControlTypeB)
doSomethingB();
// etc.
}
The list of Control
objects returned
will not contain any duplicates. And the list will not
change over time.
If no Control
is supported, a zero length
array is returned.
Control
objects.IllegalStateException
- Thrown if getControls
is called in a wrong state.
See
Player
for more details.public Control getControl(String controlType)
Control
interface.
If the specified Control
interface is not supported
then null
is returned.
If the Controllable
supports multiple objects that
implement the same specified Control
interface, only
one of them will be returned. To obtain all the
Control
's of that type, use the getControls
method and check the list for the requested type.
controlType
- the class name of the Control
.
The class name
should be given either as the fully-qualified name of the class;
or if the package of the class is not given, the package
javax.microedition.media.control
is assumed.null
.IllegalArgumentException
- Thrown if controlType
is null
.IllegalStateException
- Thrown if getControl
is called in a wrong state.
See
Player
for more details.
|
MID Profile | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |