public class Popup extends Object
Popups are used to display a
Component to the user, typically on top of all the other
Components in a particular containment hierarchy.
Popups have a very small life cycle. Once you have obtained a
Popup, and hidden it (invoked the
hide method), you should no longer invoke any methods on it. This allows the
PopupFactory to cache
Popups for later use.
The general contract is that if you need to change the size of the
Component, or location of the
Popup, you should obtain a new
Popup does not descend from
Component, rather implementations of
Popup are responsible for creating and maintaining their own
Components to render the requested
Component to the user.
You typically do not explicitly create an instance of
Popup, instead obtain one from a
protected Popup(Component owner, Component contents, int x, int y)
Popup for the Component
owner containing the Component
owner is used to determine which
Window the new
Popup will parent the
Popup creates to. A null
owner implies there is no valid parent.
y specify the preferred initial location to place the
Popup at. Based on screen size, or other paramaters, the
Popup may not display at
owner- Component mouse coordinates are relative to, may be null
contents- Contents of the Popup
x- Initial x screen coordinate
y- Initial y screen coordinate
IllegalArgumentException- if contents is null
Popup. This is provided for subclasses.
public void show()
Popup visible. If the
Popup is currently visible, this has no effect.
public void hide()
Hides and disposes of the
Popup. Once a
Popup has been disposed you should no longer invoke methods on it. A
Popup may be reclaimed and later used based on the
PopupFactory. As such, if you invoke methods on a
Popup, indeterminate behavior will result.
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.