|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.microedition.lcdui.Displayable
javax.microedition.lcdui.Screen
javax.microedition.lcdui.List
net.rim.device.api.lcdui.BlackBerryList
public class BlackBerryList
The BlackBerryList
class extends the functionality of the List
class.
The BlackBerryList
class implements Controllable
and can be queried
to retrieve BlackBerry-specific Controls
. For instance, on devices which support a virtual keyboard,
BlackBerryList.getControl(String)
may return a VirtualKeyboardControl
object.
Field Summary |
---|
Fields inherited from class javax.microedition.lcdui.List |
---|
SELECT_COMMAND |
Fields inherited from interface javax.microedition.lcdui.Choice |
---|
EXCLUSIVE, IMPLICIT, MULTIPLE, POPUP, TEXT_WRAP_DEFAULT, TEXT_WRAP_OFF, TEXT_WRAP_ON |
Constructor Summary | ||
---|---|---|
BlackBerryList(String title,
int listType)
Creates a new instance of a BlackBerryList. |
||
BlackBerryList(String title,
int listType,
String[] stringElements,
Image[] imageElements)
Creates a new instance of a BlackBerryList |
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. |
Methods inherited from class javax.microedition.lcdui.List |
---|
append, delete, deleteAll, getFitPolicy, getFont, getImage, getSelectedFlags, getSelectedIndex, getString, insert, isSelected, removeCommand, set, setFitPolicy, setFont, setSelectCommand, setSelectedFlags, setSelectedIndex, size |
Methods inherited from class javax.microedition.lcdui.Displayable |
---|
addCommand, getHeight, getTicker, getTitle, getWidth, isShown, setCommandListener, setTicker, setTitle, sizeChanged |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public BlackBerryList(String title, int listType)
IllegalArgumentException
- if listType is not one of IMPLICIT
,
EXCLUSIVE
, or MULTIPLE
.List.List(String, int)
public BlackBerryList(String title, int listType, String[] stringElements, Image[] imageElements)
NullPointerException
- if stringElements is null
NullPointerException
- if the stringElements array contains
any null elements
IllegalArgumentException
- if the imageElements array is non-null
and has a different length from the stringElements array
IllegalArgumentException
- if listType is not one of IMPLICIT
,
EXCLUSIVE
, or MULTIPLE
.
IllegalArgumentException
- if any image in the imageElements
array is mutableList.List(String, int, String[], Image[])
Method Detail |
---|
public Control[] getControls()
Controllable
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.
getControls
in interface Controllable
Control
objects.Controllable.getControls()
public Control getControl(String controlType)
Controllable
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.
getControl
in interface Controllable
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
.Controllable.getControl(String)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.