Java TV(tm) API 1.0

javax.tv.graphics
Class TVContainer

java.lang.Object
  |
  +--javax.tv.graphics.TVContainer

public class TVContainer
extends java.lang.Object

A class that allows an Xlet to get the root container for its AWT components.


Method Summary
static java.awt.Container getRootContainer(XletContext ctx)
          Get the parent container for an Xlet to put its AWT components in, if the Xlet has a graphical representation.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getRootContainer

public static java.awt.Container getRootContainer(XletContext ctx)
Get the parent container for an Xlet to put its AWT components in, if the Xlet has a graphical representation. Xlets without a graphical representation should never call this method. If the Xlet is the only Xlet that is currently active to invoke this method, it will return an instance of java.awt.Container that is initially invisible, with an undefined size and position. If another Xlet that is currently active has requested a root container (via this API, or some other platform-specific API), this method may return null.

If this method is called multiple times for the same XletContext, the same container will be returned each time.

The methods for setting the size and position of the xlet's root container shall attempt to change the shape of the container, but they may fail silently or make platform specific approximations. For example, a request to change the shape of the root container might result in its overlapping with another root container, and overlapping root containers might not be supported by the hardware. An application that needs to discover if a request to change the size or position has succeeded should query the component for the result.

Parameters:
ctx - The XletContext for the Xlet requesting the container. See the package documentation for javax.tv.xlet for a description of the relationship between Xlet and XletContext.
Returns:
An invisible container with an undefined size and position, or null if a container is unavailable.

Java TV(tm) API 1.0

Copyright © 1998 - 2000 Sun Microsystems, Inc.