| javax.microedition.xlet.XletContext
All known Subclasses: sun.mtask.xlet.PXletContextImpl, com.sun.xlet.XletContextImpl,
XletContext | public interface XletContext (Code) | | An interface that provides methods allowing an Xlet to discover
information about its environment. An XletContext is passed
to an Xlet when the Xlet is initialized. It provides an Xlet with a
mechanism to retrieve properties, as well as a way to signal
internal state changes.
See Also: javax.microedition.xlet.Xlet |
Field Summary | |
final public static String | ARGS The property key used to obtain initialization arguments for the
Xlet. |
Method Summary | |
public java.lang.ClassLoader | getClassLoader() Returns the base class loader of the Xlet. | public Container | getContainer() Get the parent container for an Xlet to put its AWT components in. | public Object | getXletProperty(String key) Provides an Xlet with a mechanism to retrieve named
properties from the XletContext.
Parameters: key - The name of the property. | public void | notifyDestroyed() Used by an application to notify its manager that it
has entered into the
Destroyed state. | public void | notifyPaused() Notifies the manager that the Xlet does not want to be active and has
entered the Paused state. | public void | resumeRequest() Provides the Xlet with a mechanism to indicate that it is
interested in entering the Active state. |
ARGS | final public static String ARGS(Code) | | The property key used to obtain initialization arguments for the
Xlet. The call
XletContext.getXletProperty(XletContext.ARGS) will
return the arguments as an array of Strings. If there are
no arguments, then an array of length 0 will be returned.
See Also: XletContext.getXletProperty |
getClassLoader | public java.lang.ClassLoader getClassLoader()(Code) | | Returns the base class loader of the Xlet. This class loader
will be dedicated exclusively to the xlet. The xlet's classes are
all loaded by this classloader or by a classloader that has this
classloader as its ancestor.
|
getContainer | public Container getContainer() throws UnavailableContainerException(Code) | | Get the parent container for an Xlet to put its AWT components in.
Xlets without a graphical representation should never call this method.
If successful, this method returns an instance of java.awt.Container that
is initially invisible, with an arbitrary size and position.
If this method is called multiple times on the same XletContext instance,
the same container will be returned each time.
The methods for setting the size and position of the xlet's parent
container shall attempt to change the shape of the container, but they may
fail silently or make platform specific approximations. To discover if
a request to change the size or position has succeeded, the Xlet should
query the container for the result.
An invisible container with an arbitrary size and position. exception: UnavailableContainerException - - If policy or screen real estate does not permit a Container to be granted to the Xlet at this time. |
getXletProperty | public Object getXletProperty(String key)(Code) | | Provides an Xlet with a mechanism to retrieve named
properties from the XletContext.
Parameters: key - The name of the property. A reference to an object representing the property.null is returned if no value is available for key. |
notifyDestroyed | public void notifyDestroyed()(Code) | | Used by an application to notify its manager that it
has entered into the
Destroyed state. The application manager will not
call the Xlet's destroy method, and all resources
held by the Xlet will be considered eligible for reclamation.
Before calling this method,
the Xlet must have performed the same operations
(clean up, releasing of resources etc.) it would have if the
Xlet.destroyXlet() had been called.
|
notifyPaused | public void notifyPaused()(Code) | | Notifies the manager that the Xlet does not want to be active and has
entered the Paused state. Invoking this method will
have no effect if the Xlet is destroyed, or if it has not
yet been started.
If an Xlet calls notifyPaused() , in the
future it may receive an Xlet.startXlet() call to request
it to become active, or an Xlet.destroyXlet() call to request
it to destroy itself.
|
resumeRequest | public void resumeRequest()(Code) | | Provides the Xlet with a mechanism to indicate that it is
interested in entering the Active state. Calls to this
method can be used by an application manager to determine which
Xlets to move to Active state.
If the request is fulfilled, the application manager will
subsequently call Xlet.startXlet()
via a different thread than the one used to call
resumeRequest() .
See Also: Xlet.startXlet |
|
|